Add and use filters in the Stores grid

Filters in Store Locator → Stores narrow the administration table. They are not the public Search-form or Layout widgets visitors use.

Built-in filters

The toolbar search matches Store name, city, and slug. Click Filters for:

Filter	Behavior
Status	Active, Pending review, Relocated, Temporarily closed, or Permanently closed
Country	Select from the configured admin country options
City	Contains the typed city text
Category	Multi-select relationship filter
Brand	Brand relationship filter

The number on the Filters button is the count of currently applied non-empty filters. Filters combine, so choosing Active + Pizza + Mumbai returns Stores satisfying all constraints.

Add a Custom Field to admin filters

1. Open Store Locator → Custom Fields.
2. Add or edit a field with Applies To → Stores.
3. Enable Show in list filters.
4. Save the field and reload Stores.
5. Click Filters and use the newly added control.

Select, radio, and checkbox-style fields use their configured choice values. Checkbox/multi-value fields become multi-select filters. Fields without choices use text matching. The filter operates on the stored choice value, while the interface displays its label.

Category-scoping a Custom Field controls which Store edit forms show it. Existing values on Stores outside that scope can still matter during data cleanup, so review values before changing scope.

When a custom filter returns no records

Check that the Store actually has a saved value, the Custom Field is active, and the choice value was not changed after Stores were populated. Renaming a choice label is safe; changing its stored value can make existing data no longer match that choice.

Use Refresh after editing Custom Field definitions. Clear other active filters before diagnosing one field.

Add a filter in PHP

Developers can use cliq_sl_admin_store_filters to append or alter Store-grid definitions. Set source => enriched when the value comes from a relationship, metadata, or schema coordinator rather than a direct Stores-table column.

add_filter(
    'cliq_sl_admin_store_filters',
    static function (array $filters): array {
        $filters['featured_store'] = [
            'label'    => 'Featured',
            'type'     => 'select',
            'options'  => ['1' => 'Yes', '0' => 'No'],
            'operator' => 'equals',
        ];
        return $filters;
    }
);

See PHP actions and filters for the complete signature and other extension points.