# Filter

## Filtering Data in the Grid

Filters help you narrow down grid data so you can focus on the records that matter. Similar to Excel-style filtering, filters temporarily hide records that do not meet your criteria, making analysis faster and more effective.

You can filter data using:

* **Scope (Show) filters** *(Wave Extension Only)*
* **Filters**
* **Filter Groups**
* **Cross Filters**
* **Dynamic Filter**

All filters work together and are applied in sequence to determine the final set of records shown in the grid.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FHspnfjaG4AYFTCSsvfdL%2FFilters.gif?alt=media&#x26;token=72ec7e0c-d638-4e74-bfd4-d4af41f63c9d" alt=""><figcaption><p>Access Filter</p></figcaption></figure>

### Filter Components Overview

The Filters panel includes the following options:

* **Show** – Limits records based on Salesforce-defined visibility scopes *(Wave Extension Only)*
* **Filter Collection** – Save and reuse multiple filter configurations within a grid
* **Add a Filter** – Adds a single filter condition
* **Add a Filter Group** – Combines multiple filters using both AND and OR logic
* **Add a Cross Filter** – Filters parent records based on related child records

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F2dhU0mTI0maRiDGHbCik%2Fimage.png?alt=media&#x26;token=244b86f7-acd2-4df7-8d96-523789fc262c" alt=""><figcaption></figcaption></figure>

### Show (Scope Filters)

The **Show** dropdown displays Salesforce standard visibility scopes for the selected object. These scopes determine **which records are initially included** before any additional filter conditions are applied. **This is only applicable in Wave Extension**.

The available options vary based on:

* The selected object
* Salesforce features enabled (such as Teams or Territories)
* User role, permissions, and ownership

#### Examples

**Lead object**

* All Leads
* My Leads
* Queue Owned Leads
* My Team’s Leads
* User Owned Leads
* Filter by Scope (Salesforce-defined ownership or territory rules)

**Account object**

* All Accounts
* My Accounts
* My Team’s Accounts
* Filter by Scope (Salesforce-defined ownership or territory rules)

> All filter conditions added later apply **only to the records returned by the selected Show option**.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FON0Ds0KLzGaMa1i0HLWS%2FShow%20Filters.png?alt=media&#x26;token=28cd1bc7-f03b-404c-88a7-0c3ac4269d67" alt=""><figcaption></figcaption></figure>

***

## Filter Collection

Filter Collections allow you to **save and reuse multiple filter configurations** within a grid. This helps you quickly switch between different filtered views without recreating filters each time.

* A Filter Collection contains one or more filters
* Multiple collections can be created per grid
* Collections are saved automatically when changes are made
* Changes apply after saving the grid

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2Ff9ZUnzva6rkQLddVXsb2%2FFilter%20Collection.gif?alt=media&#x26;token=49064d89-1d32-437f-82de-b839b59aa17d" alt=""><figcaption><p>Filter Collection</p></figcaption></figure>

### Managing Filter Collections

* **Save a Filter Collection**\
  Save your current filter setup using the **Save** option in the filter panel.\
  A default name is assigned (e.g., *Accounts Filter 1*), which can be updated inline.
* **Rename a Filter Collection**\
  Update the name directly in the Filter Collections section. Names must be unique and not empty.
* **Duplicate a Filter Collection**\
  Create a copy of an existing collection. The new collection will include *“Copy”* in its name.
* **Delete a Filter Collection**\
  Remove a collection and its filters. At least one collection must always remain.
* **Switch Between Collections**\
  Select a Filter Collection to instantly apply a saved filter configuration.

#### Notes

* Filter editing is controlled by [**Filters permission**](https://docs.valorx.com/valorx-wave/wave-experience/create-a-new-grid/grid-wizard-in-salesforce#filters)**.**
* Existing filters are automatically saved as a **Default Filter Collection**

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F7UqKZIeFO5ppJswDcvrF%2Fimage.png?alt=media&#x26;token=f3995a2f-e763-464c-892c-453bde9584e0" alt=""><figcaption><p>Default Filter</p></figcaption></figure>

***

## Adding a Filter

Use **Add a Filter** to apply a single condition.

### Filter Structure

Each filter row consists of three parts:

<table data-header-hidden><thead><tr><th width="116.6666259765625">Component</th><th>Description</th></tr></thead><tbody><tr><td><strong>Field</strong></td><td>Select the column you want to filter. You can search for fields or filter by data type for faster selection.</td></tr><tr><td><strong>Condition</strong></td><td>Choose how the field should be compared. Refer to the <strong>Condition Quick Guide</strong> below for details.</td></tr><tr><td><strong>Value</strong></td><td>Enter the value to filter by. This can be a <strong>static value</strong> (fixed text, number, or date) or a <strong>Dynamic Parameter</strong> (Wave Embedded Only).</td></tr></tbody></table>

#### Steps

1. Click **Filter**
2. Click **+ Add a Filter**
3. Choose a field, condition, and value
4. Click **Apply**

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2F4IcwGFjJhkqkwx3znlIT%2FFilter.gif?alt=media&#x26;token=e783d6aa-3fb3-4594-8676-558d62241555" alt=""><figcaption><p>Filter</p></figcaption></figure>

### **Condition Quick Guide**

<table><thead><tr><th width="163.33331298828125">Condition</th><th>What it Does</th><th>Example</th><th>When to Use</th></tr></thead><tbody><tr><td>Contains</td><td>Field includes the specified value anywhere</td><td>Name Contains “John” → “John Smith”, “Alice Johnson”</td><td>When you want partial matches</td></tr><tr><td>Does Not Contain</td><td>Field does not include the specified value</td><td>Name Does Not Contain “John” → “Alice Smith”</td><td>To exclude records containing certain text</td></tr><tr><td>Starts With</td><td>Field begins with the specified value</td><td>Name Starts With “Jo” → “John Smith”, “Johnny Appleseed”</td><td>When matching the beginning of text</td></tr><tr><td>Ends With</td><td>Field ends with the specified value</td><td>Name Ends With “son” → “Alice Johnson”</td><td>When matching the end of text</td></tr><tr><td>Is</td><td>Field exactly matches the specified value</td><td>Stage Is “Closed Won” → Only “Closed Won”</td><td>When you need an exact match</td></tr><tr><td>Is Not</td><td>Field does not exactly match the specified value</td><td>Stage Is Not “Closed Won” → All others</td><td>To exclude exact values</td></tr><tr><td>Is Any Of</td><td>Field matches any value in a list</td><td>Billing State Is Any Of “Texas, Ohio” → Records in Texas or Ohio</td><td>When you want to match multiple specific values</td></tr><tr><td>Is None Of</td><td>Field does not match any value in a list</td><td>Industry Is None Of “Utilities, Retail” → All except Utilities or Retail</td><td>To exclude multiple specific values</td></tr><tr><td>Is Empty</td><td>Field has no value (blank)</td><td>Phone Is Empty → Records with no phone</td><td>To find missing information</td></tr><tr><td>Is Not Empty</td><td>Field has any value</td><td>Email Is Not Empty → Records with email</td><td>To find records with information</td></tr></tbody></table>

### Applying Multiple Filters

You can add multiple filters using **+ Add a Filter**.

When applying multiple filters:

* All conditions must use **either AND or OR**
* Mixing AND and OR is **not supported** without a Filter Group

#### Example

Find Account where:

* Industry is Communications\
  **AND**
* Annual Revenue is greater than 300,000\
  **AND**
* Active is Yes

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2Fnhk3XhVBovBWputjW06i%2FMultiple%20Filter.gif?alt=media&#x26;token=866e9ad9-a821-4a1f-81b3-d481439b5e92" alt=""><figcaption><p>Multiple Filters</p></figcaption></figure>

***

## Filter Groups

Use **Filter Groups** when you need to combine **AND and OR conditions** in the same filter logic.

### When to Use Filter Groups

| Scenario                         | Use              |
| -------------------------------- | ---------------- |
| Single logic (all AND or all OR) | Multiple Filters |
| Mixed logic (AND + OR)           | Filter Group     |

#### Example

Find Account where:

* Industry is Communications\
  **AND**
* Annual Revenue is greater than 300,000\
  **OR**
* Active is Yes

### Creating a Filter Group

1. Click **Add a Filter Group**
2. Choose **AND** or **OR**
3. Add filters or nested filter groups as needed
4. Click **OK**

Filter Groups allow you to be very precise by nesting conditions and combining logic.

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FM0RdwGqD5XFINke5S6bm%2FGroup%20Filter.gif?alt=media&#x26;token=829fdc9a-94b2-42f0-9fdf-bcad23c44646" alt=""><figcaption><p>Filter Group</p></figcaption></figure>

***

## Multiple Filters vs Filter Groups

When filtering data, you can apply **multiple filters** or use a **filter group**. The key difference is how conditions are combined.

#### Multiple Filters

Use multiple filters when **all conditions use the same logic**.

* All conditions must use **AND** *or* **OR**
* Simple and easy to configure
* Ideal for straightforward filtering

#### Filter Groups

Use a filter group when you need to **combine AND and OR conditions**.

* Allows mixing AND and OR
* Supports nested conditions
* Ideal for more complex filtering logic

#### Quick Tip

> **If your filter logic includes both “AND” and “OR”, use a Filter Group.**

***

## Cross Filters

Cross Filters allow you to filter **parent records** based on related **child records**.

They help answer questions such as:

* Accounts with Cases
* Accounts without Contacts
* Opportunities with Products but without Schedules

#### Supported Capabilities

* With / Without related records
* Multiple cross filters
* Optional child-level conditions (With only)
* Combination with standard filters and filter groups

#### Example: Accounts with Opportunity

**Configuration**

* Grid Object: Account
* Cross Filter: With → Opportunity

**Result**

* Displays only Accounts that have at least one related Opportunity

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FlmgUDVEyWo7XKte4nTNf%2FCross%20Filter%20v2.gif?alt=media&#x26;token=e8d5a9e3-41c0-478f-a6a4-2cfefdbfc929" alt=""><figcaption><p>Cross Filter</p></figcaption></figure>

***

## Dynamic Filter (Wave Embedded Only)

Dynamic Filters allow filter values to be passed **at runtime** instead of using fixed values.

They are commonly used in:

* Embedded grids
* Flows
* Components (LWC / Aura)

Dynamic Filters enable scenarios where filter values depend on:

* User input
* Context variables
* Component parameters

> Dynamic Filters are supported **only in Wave Embedded**.

Find out more about Dynamic Filter [here](https://docs.valorx.com/valorx-wave/wave-data-management/managing-grid-data/dynamic-filter).

<figure><img src="https://2237973035-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F65f4C4H8V5e0YV342mwp%2Fuploads%2FObGzr2URApxJeuNCNeVB%2FDynamic%20Filter%20Apply.gif?alt=media&#x26;token=22cdbcf9-7db7-4ba7-aba7-77e47c986415" alt=""><figcaption></figcaption></figure>

***

## Additional Notes

* Copy a filter using the **Copy** icon
* Remove a filter using the **Delete** icon
* Use **Clear All** to remove all filters at once
* The filter count appears on the Filters button when filters are applied

#### Standard Grid Behavior

When filters are applied to a Standard Grid for the first time:

* A **new Custom Grid** is automatically created
* A toast notification confirms the creation
* All future changes are saved to the Custom Grid

***
