Important: Upcoming synchronization filters upgrade
On October 23, 2025, we’re introducing a new and more flexible filtering system to enhance your synchronization options.
This upgrade will:
- Enable filtering on product variants
- Expand filtering capabilities by including all PIM REST API operators
As part of this change, existing filters - such as Completeness, Filter attribute, and the Category field - will be migrated to the new system. Going forward, all synchronization filters will be managed under the “Synchronization filters” section in the Configuration tab.
Until November 24, both the legacy and new filtering systems are available in the app.
Please note that the legacy filters take priority as long as you haven’t performed a manual migration.
If your store is already configured in the app, we recommend reviewing your current filters and preparing for the transition to take full advantage of the new features.
Manual migration
To migrate your current filters (Completeness, Filter attribute, Category code, and Variant status), go to the Configuration tab of the app, open the Synchronization filters section, and click Migrate.
Your existing filters on scheduled synchronizations will be converted to the new format and removed from the legacy system.
Automatic migration
If you don’t perform the migration manually, an automatic migration will take place on November 24.
At that time, all existing filters will be migrated to the new system, and the legacy filters will be permanently removed.
Synchronization filters
This section explains how product selection works in the Akeneo app for Shopify.
What are synchronization filters?
Synchronization filters are filters that can be applied to simple products, product models, and variants during the synchronization process. They represent the product selection - or products and products with variants that will be synced to Shopify.
This mapping is optional. However, if no filters are defined, the app will synchronize all simple products, product models and variants from your PIM without applying any criteria.
Supported filtering levels
| Filtering level | Supported? |
|---|---|
| Simple product | Yes |
| Product model | Yes |
| Product variant | Yes |
Create synchronization filters
Follow these steps to create your custom filters:
- In your Akeneo App for Shopify, navigate to the Configuration page.
- In the Synchronization filters section, you'll see three sections:
•"product_filters":{},: corresponding to simple product filters.
•"product_model_filters": {},: corresponding to product model filters.
•"product_variant_filters": {}: corresponding to product variant filters.
For each section, you can define your own filters using the same REST API structure, but you don’t need to include the URL or thesearch=parameter:"attribute_code":[{"operator":"operator","value":value}]
Example with the PIM status:{"enabled":[{"operator":"=","value":true}]} - Check the product selection counter to make sure your filter is applied as expected.
- Save your configuration.
Filter example
Here’s an example of a filter that can be applied to your simple products, product models, and product variants.
For the full list of available filters and operators, please refer to the REST API documentation.
{
"product_filters": {
"categories":[{"operator":"IN CHILDREN","value":["clothing_catalog"]}],
"enabled":[{"operator":"=","value":true}],
"family":[{"operator":"IN CHILDREN","value":["pants","tshirt","shoes"]}],
"send_to_shopify":[{"operator":"=","value":true}]
},
"product_model_filters": {
"categories":[{"operator":"IN CHILDREN","value":["clothing_catalog"]}],
"family":[{"operator":"IN CHILDREN","value":["pants","tshirt","shoes"]}],
"send_to_shopify":[{"operator":"=","value":true}]
},
"product_variant_filters": {
"enabled":[{"operator":"=","value":true}],
"send_to_shopify":[{"operator":"=","value":true}]
}
}Please note that the parent and updated_at filters are not allowed in the app.