How filters work
Every filter has three parts:- Source field — where the filtering value comes from (the user’s profile or a CRM field)
- Product field — the field on the product that the source value is compared against
- Match logic — if the source value matches the product field value, the product is visible
Source fields
The source field determines where the filtering value comes from. Veles supports two sources:User fields
These are attributes stored directly on the user’s profile in Veles. You configure these when adding users.| Field | Type | Description |
|---|---|---|
| Text | The user’s email address. | |
| Job Title | Text | The user’s job title. |
| Role | Single Select | The user’s role: Admin, Member, or Viewer. |
| Regions | Array | The regions assigned to the user (e.g., North America, EMEA, APAC). |
CRM fields
If you’ve connected a CRM (Salesforce or HubSpot), you can also pull source values from CRM fields. This lets you build filters based on data that lives in your CRM rather than duplicating it in Veles. For example, if your CRM tracks which vertical a rep covers (Healthcare, FinTech, Manufacturing), you can use that CRM field as the source for a product filter without re-entering the data on each user’s Veles profile.Creating a filter
- Navigate to Admin > Price Books > Filters.
- Click + Add Product Filter.
- Name the filter with something descriptive (e.g., “Region-based visibility” or “Vertical product matching”).
- Select the source field. Choose the User or CRM tab, then pick the field that provides the filtering value.
- Map it to a product field. Select the corresponding field on the product that the source value should be compared against.
- Set the Status to Active. Active filters are applied whenever users view products. Inactive filters are saved but don’t affect visibility.
- Click Save Changes.
Advanced options
The filter builder includes two advanced settings for handling edge cases. These are optional but important for avoiding unexpected behavior in larger catalogs.Include products with blank values
What it does: When a product doesn’t have the target field set at all, the filter would normally exclude it. Enabling this option lets those products pass through the filter instead. When to use it: Turn this on when a blank value means “applies to everyone” rather than “not configured yet.” Example: You filter products byregion_ids, but some products are global and don’t have any regions assigned. Enabling this setting ensures those global products still appear for all users, while region-specific products are filtered normally.
Default source value
What it does: When the source value is unavailable (e.g., a user has no region assigned), the filter is normally skipped entirely. Setting a default means the filter runs using this fallback value instead. When to use it: Use this when skipping the filter for users with missing data would show too many (or too few) products. Leave it blank if skipping the filter is the right behavior for your team. Example: You filter products by the user’s Region, but new hires don’t have a region assigned yet. Setting a default ofus-east ensures they see US East products instead of seeing everything (unfiltered) or nothing.
Common filter patterns
Region-based visibility
The most common filter. Match the user’s Regions field against a Region custom field on the product.- Source: User > Regions
- Product field: Region
- Result: A rep assigned to EMEA only sees products tagged with EMEA. A rep assigned to both EMEA and APAC sees products tagged with either.
- Tip: Enable “Include products with blank values” so global products (no region set) appear for everyone.
Segment-based visibility
Match the user’s assigned segment against a Segment custom field on the product.- Source: User > Segment (or a CRM field if segments are managed in your CRM)
- Product field: Segment
- Result: An Enterprise rep only sees Enterprise-tier products. An SMB rep only sees SMB-tier products.
Vertical-based visibility
Use a CRM-sourced field to filter products by the rep’s industry vertical.- Source: CRM > Vertical (e.g., a custom field on the Salesforce User or HubSpot owner record)
- Product field: Vertical
- Result: A rep covering Healthcare only sees products relevant to Healthcare customers.
How multiple filters interact
When multiple filters are active, they’re evaluated together. A product must pass all active filters to be visible to a user. For example, if you have both a Region filter and a Segment filter active:- A product tagged with Region = “North America” and Segment = “Enterprise” is visible only to reps who are assigned to North America and Enterprise.
- A product tagged with Region = “North America” and no Segment is visible to North America reps only if “Include products with blank values” is enabled on the Segment filter.
Managing filters
Editing a filter
Navigate to Admin > Price Books > Product Filters and select the filter. Update the name, source field, product field, or advanced options, then click Save Changes.Deactivating a filter
Set the filter’s Status to inactive. The filter configuration is preserved but no longer applied when users view products. This is useful for testing or temporarily broadening catalog visibility.Deleting a filter
Remove the filter entirely from Admin > Price Books > Product Filters. This immediately makes all products that were previously hidden by the filter visible to users who can now see them.What’s next
Product Custom Fields
Define the product-side fields that filters match against.
Adding Users
Assign regions, segments, and other attributes that filters use as source values.
Connect your CRM
Pull CRM fields into Veles to use as filter sources.
Product Categories
Organize products into families for catalog navigation and rule logic.

