# Bricks Element Condition: URL Parameter

> Adds a "URL parameter" condition to Bricks element conditions, so you can show an element only when the address contains something like ?ref=newsletter.

- Type: PHP
- Runs: Run everywhere
- Category: [Page Builders & Themes](https://wpide.com/library/category/page-builders/)
- Tags: bricks, conditions, landing-pages
- Author: WPIDE Team
- Installs: 0
- Updated: 2026-10-28
- Page: https://wpide.com/library/bricks-condition-url-parameter/

## Code

```php
add_filter( 'bricks/conditions/groups', function ( $groups ) {
    $groups[] = array( 'name' => 'wpide', 'label' => 'Site rules' );

    return $groups;
} );

add_filter( 'bricks/conditions/options', function ( $options ) {
    $options[] = array(
        'key'     => 'wpide_url_param',
        'label'   => 'URL parameter',
        'group'   => 'wpide',
        'compare' => array(
            'type'        => 'select',
            'options'     => array( '==' => 'is', '!=' => 'is not' ),
            'placeholder' => 'is',
        ),
        'value'   => array( 'type' => 'text', 'placeholder' => 'ref=newsletter' ),
    );

    return $options;
} );

add_filter( 'bricks/conditions/result', function ( $result, $condition_key, $condition ) {
    if ( 'wpide_url_param' !== $condition_key ) {
        return $result;
    }

    $rule    = isset( $condition['value'] ) ? (string) $condition['value'] : '';
    $compare = isset( $condition['compare'] ) ? $condition['compare'] : '==';
    $parts   = explode( '=', $rule, 2 );
    $name    = sanitize_key( $parts[0] );
    $current = ( $name && isset( $_GET[ $name ] ) ) ? sanitize_text_field( wp_unslash( $_GET[ $name ] ) ) : null; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
    $match   = isset( $parts[1] ) ? ( null !== $current && $current === $parts[1] ) : null !== $current;

    return '!=' === $compare ? ! $match : $match;
}, 10, 3 );
```

## Notes

Enter the value as name=value (for example ref=newsletter), or just the name to test that the parameter exists.

## How to use it

Install the free WPIDE plugin (https://wordpress.org/plugins/wpide/), find "Bricks Element Condition: URL Parameter" in its snippet library and add it in one click; or create a new PHP snippet in WPIDE (or any code snippets plugin) and paste the code above. More snippets: https://wpide.com/library/