Synchronization

Summary

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:

  1. Products import: Select this option to import simple products - without variants.
  2. 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: 

  1. Navigate to the Synchronization tab.
  2. Click on the Manual sync button.
  3. In the modal that appears, select the desired import process: Full importor Delta import.
  4. (Optional) Set filters.
  5. 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:

  1. Navigate to the Synchronization tab.
  2. Click on the Schedule sync button.
  3. In the modal that appears, select the desired import frequency: daily, weekly, or monthly.
  4. (Optional) Set filters.
  5. Click Save to confirm your selection.

 

If you wish to deactivate the scheduled synchronization, follow these steps:

  1. Go to the Synchronization tab.
  2. Locate the scheduled synchronization you want to deactivate.
  3. Click on the Schedule sync button.
  4. In the modal that appears, change the frequency to Never.
  5. 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.