Synchronization
This section provides an overview of the different types of synchronization and how they work.
Synchronization
The synchronization section is where the magic happens! Here, you can launch import jobs to seamlessly transfer product data from your PIM to your Shopify store.
Synchronization scope
There are two types of synchronization available:
- Products import: Select this option to import simple products - without variants.
- Products with variants import: Select this option to import products with variants.
Synchronization type
Manual synchronization
The app allows you to launch your synchronizations manually.
To launch a synchronization manually, follow the steps below:
- Navigate to the Synchronization tab.
- Click on the Manual sync button.
- In the modal that appears, select the desired import process: Full importor Delta import.
- (Optional) Set filters.
- Click on Launch synchronization.
Scheduled synchronization
With the App, you have the flexibility to schedule your imports regularly. You can choose from the following frequencies:
- Daily
- Weekly
- Monthly
Synchronization start times are automatic:
- Products: 8:30 AM (UTC)
- Products with variants: 2:30 PM (UTC)
To schedule your imports:
- Navigate to the Synchronization tab.
- Click on the Schedule sync button.
- In the modal that appears, select the desired import frequency: daily, weekly, or monthly.
- (Optional) Set filters.
- Click Save to confirm your selection.
If you wish to deactivate the scheduled synchronization, follow these steps:
- Go to the Synchronization tab.
- Locate the scheduled synchronization you want to deactivate.
- Click on the Schedule sync button.
- In the modal that appears, change the frequency to Never.
- Click Save to confirm your selection.
By deactivating the scheduled synchronization, the import jobs will no longer run automatically according to the previously set frequency.
Apply filters to your imports
List of available filters:
| Filter | Scope | Import type | Information |
|---|---|---|---|
| Import process | Products, Products with variants |
Manual, Scheduled | Required The filters feature allows you to choose if you want to perform a full or delta import: • Full import: this process is used to import the whole catalog: products, media, and metafields. Please use the full import for the first synchronization with the App. • Delta import: this process is used to import changes made in the PIM catalog since the last synchronization: creating new products or updating values on products. Please use the delta import to reduce the import duration. |
| Completeness | Product | Manual | Optional This filter allows products to be synchronized according to their completeness in the PIM. Only products with completeness greater than or equal to that used in the filter will be synchronized. |
| Import media | Products, Products with variants |
Manual | Optional When deselected, this filter allows you not to synchronize mapped media and to save time on the import. |
| Import metafields | Products, Products with variants |
Manual | Optional When deselected, this filter allows you not to synchronize mapped metafields and to save time on the import. |
| Filter attribute | Products, Products with variants |
Manual, Scheduled | Optional This filter allows products to be synchronized according to the value of a Boolean attribute: • Yes: the product is synchronized • No: the product is not synchronized • Empty: the product is not synchronized The Boolean attribute must be created in the PIM at the product level and then mapped into the Akeneo App for Shopify. Please note that the filter can only be applied at the product level and not at the variant level. |
| Import secondary locales | Products, Products with variants |
Manual, Scheduled | Optional When deselected, this filter allows you not to synchronize secondary locales and to save time on the import. |
| Import pre-existing products only | Products, Products with variants |
Manual, Scheduled | Optional This filter allows you to synchronize only pre-existing products or products with variants. New products will not be synchronized. When deselected, all products will be processed, whether pre-existing in Shopify or not. |
In the Synchronization section, you can only consult the import that is currently in progress. You will be able to verify the type of synchronization job, the method used, and the duration. Please consult the History if you need additional information about past jobs.
Product synchronization
Product synchronization allows you to import all simple products - without variants - and their attributes.
By default, all products are synchronized, regardless of their status in Akeneo. The PIM Product status is automatically synchronized with the Shopify product Status.
- Set to Active in Shopify if the Product status is enabled
- Set to Draft in Shopify if the Product status is disabled
Product deletion
Deleting synchronized products in Shopify is not handled by the app. If a product is deleted on the Akeneo side, it must be manually deleted in Shopify.
If a product is deleted in Shopify, it must be manually deleted in Akeneo. Otherwise, it will be recreated by the app during the next synchronization.
Product with variants synchronization
Product with variants synchronization allows you to import all product models, variants, and their attributes.
All products with variants are synchronized, regardless of their variant status in Akeneo. The Shopify product Status is automatically set to Active.
Please note that there is an exception: if a product model has no enabled variants in Akeneo, the product model is not synchronized.
List of compatible attributes as variation axis
| Attribute type | Supported by the App |
|---|---|
| Simple select | Yes |
| Measurement | Yes |
| Boolean | Yes |
| Reference entity single link | Yes |
Product with variants deletion
Deleting synchronized products with variants in Shopify is not handled by the app.
If a product model is deleted on the Akeneo side, it must be manually deleted in Shopify.
If a product model is deleted in Shopify, it must be manually deleted in Akeneo. Otherwise, it will be recreated by the app during the next synchronization.
If a product variant is deleted on the Akeneo side, it is automatically deleted in Shopify.
If a product variant is deleted in Shopify, it must be manually deleted in Akeneo. Otherwise, it will be recreated by the app during the next synchronization.
Synchronization Status
The following synchronization statuses are available in the Shopify App:
| Status | Definition |
|---|---|
| PENDING | The job has been launched but not running yet. This status should last no more than a few seconds. |
| IN PROGRESS | The import is proceeding. The length will vary depending on the number of products imported. |
| SUCCESS | The import is finished with no warnings or errors. It means that all your Products have been imported entirely with the information entered in your PIM instance. |
| WARNING | The import is done with warnings and/or errors. If you did receive the following information: "Your job is completed, but it contains: X warnings X errors" It means that your job has been completed, but some of the products or product attributes could not be imported. Please consult the import logs. |
| ERROR | The import has crashed with an error. It usually means that there is an overall problem with either PIM or Shopify instance. Please consult the import logs. |
| STOPPED | The import was stopped before its end. Please contact the support team. |