Smart Feed (New): Filtering Products by Variant in Sync Scope Settings (Coming Soon)
The Variant filter in Smart Feed (New) lets you control exactly which products are synced to your ad channels based on their variant attributes — such as size, color, material, or style. This is especially useful when you want to promote a targeted selection of products, for example, syncing only plus-size items first before expanding to the full catalog, or quickly adding a best-seller to your feed once it gains traction. This guide explains how to add a Variant filter to your product sync scope, configure its options and operators, and use it in Custom Label automation rules.
Prerequisites for Using the Variant Filter
Before adding a Variant filter, make sure the following are in place:
- You have Smart Feed (New) set up in your store.
- Your feed's product sync scope is set to Partial Products. The Variant filter is only available when syncing a subset of your catalog.
Adding a Variant Filter to Your Product Sync Scope
To filter products by variant for a specific feed:
- Go to Smart Feed (New) > Manage channels > Manage feeds and open the feed you want to configure.
- In the feed settings, locate Product Sync Scope and select Some products.
- Under Select products, choose the filter condition panel.
- Click Add filter condition and select Variant from the filter field dropdown.
- Choose a Variant sub-option (see the table in the next section for details).
- Select an operator: Yes or No
- Enter the value you want to match. The system performs an exact match against your product data -enter the value exactly as it appears in your store.
- If the Sync Method is set to API, click the Sync Now button on the page to apply the filter. If the Sync Method is set to XML, the system will automatically update the filtered results to the XML file approximately every two hours.
| Note: You can add multiple filter conditions to narrow your product selection further. Products must meet all conditions to be included in the sync. |
Variant Filter Options and Operators
When you select the Variant filter, choose one of five sub-options:
| Sub-option | Description |
| Color | Filter by the product's color variant. |
| Size | Filter by the product's size variant. |
| Material | Filter by the product's material variant. |
| Style | Filter by the product's style variant. |
| Custom | Enter a custom variant attribute name that exists in your store. |
After selecting a sub-option, choose one of the following operators:
| Operator | What it does |
| Yes | Includes products whose variant value exactly matches your input. |
| No | Includes products whose variant value does not match your input. |
| Note: Matching is based on exact values from your store's product data. For best results, copy the variant value directly from your product settings to avoid mismatches caused by spelling differences or extra spaces. |
Using a Custom Variant Attribute
If your store uses a variant attribute that is not one of the four defaults (Color, Size, Material, Style), you can filter by it using the Custom option.
To add a custom variant filter:
- Follow steps 1–4 in the section above to open the filter condition panel and select Variant.
- In the sub-option dropdown, select Custom.
- An input field appears. Type the exact name of the variant attribute as it exists in your store (for example, Scent or Fit).
- Select an operator and enter the value to match.
- Click Save.
Using the Variant Filter in Custom Label Automation Rules
The Variant filter is also available when setting up automation rules for Custom Labels. This lets you automatically assign labels to products based on their variants, which you can then use to organize and target your ad campaigns.
To add a Variant condition to a Custom Label automation rule:
- Go to Smart Feed (New) > Channel Management > Field Settings.
- Open the Custom Labels section and click Add Automation Rule.
- In the rule condition panel, click Add Condition and select Variant from the dropdown.
- Choose a sub-option (Color, Size, Material, Style, or Custom), select an operator, and enter the value to match.
- Finish configuring the rule and click Save.
| Note: The previous separate Color, Size, Material, and Pattern condition fields in Custom Label automation rules have been consolidated into the single Variant field. If you previously used those fields, recreate your conditions using Variant with the corresponding sub-option. |
Supported Channels for Variant Filtering
The Variant filter is supported across all channels available in Smart Feed (New):
- Meta
- Snapchat
- TikTok
- Criteo
- Microsoft
- Universal XML