Data Synchronization



Execution tab

Once the configuration and mapping of the App are completed, the Execution tab becomes available.

The Execution tab is composed of two sections:

  • Synchronization - This section allows you to run imports
  • History - This section allows you to health check your import and consult details



The synchronization section is actually where the magic happens!

You will be able to launch your import jobs to transfer the product data from PIM into your Shopify store.

There are two synchronization types:

  • Simple products import
  • Product variants import


Schedule your imports

The App allows you to schedule your imports on a recurring basis at different frequencies: 

  • Daily 
  • Weekly
  • Monthly


How to schedule your imports ?

  1. From the Execution tab, click on the Schedule button.
  2. In the modal, select the frequency at which you wish to import the products: daily, weekly, monthly.
  3. Click on Save.

How to deactivate the scheduled synchronization?

You can disable scheduled synchronization by changing the frequency to Never.


Apply filters to your imports


List of available filters:

Filter Scope Import type Information
Import process Simple products, 
Product models & variants
Manual, Scheduled 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 Simple products, 
Product models & variants
Manual 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 Simple products, 
Product models & variants
Manual When deselected, this filter allows you not to synchronize mapped media and to save time on the import.
Import metafields Simple products, 
Product models & variants
Manual When deselected, this filter allows you not to synchronize mapped metafields and to save time on the import.
Filter attribute  Simple products, 
Product models & variants
Manual, Scheduled 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 and then mapped into the Akeneo App for Shopify.


In the Execution 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 execution time. Please consult the History tab if you need additional information about past jobs.


Categories/collections import

Shopify does not use a categorization system similar to PIM. To sync your PIM categories, you have the possibility to use Shopify's Product tags field to create Automated collections.

To do this, follow the steps below:

  1. Create a new PIM attribute and add it to your PIM family. The attribute type can be simple-select or multi-select.
  2. Create and select attribute options to categorize your product. E.g: clothing, men, top, shirts.
  3. In your Akeneo App for Shopify, map this PIM attribute with Tags. Then, synchronize your products.
  4. In Shopify, create your automated collection based on your selected product tag. You can find more information on this page.


Simple products import

You will launch simple product synchronization to import your Simple products (products without the variants) from your PIM to your Shopify store.

To run the import of your simple products, click on Launch now and confirm the filter application. The job will launch automatically.



According to your mapping, all mapped fields will be imported into your Shopify store. If there is any field missing in your Shopify store after the import is completed: please double-check that you filled in all necessary information in the correct channel and locale instance.

In case it was a reason for the issue, you will be able to run a differential import to complete the missing information in your Shopify store.

You can verify your CHANNEL/LOCALE information in your PIM instance >> Product:


Please note that:

  • PIM is our source of truth for the App. Therefore if you delete a product in your Shopify store, please make sure to do the same in the PIM. Otherwise, the Product in question will be recreated.
  • The App does not manage the removal (deletion) of products. It is only possible for product attribute values. Therefore make sure to perform the change manually both in your PIM and Shopify instances.


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.
RUNNING 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.



In the History section, you can see all previous imports.

The imports are classified from the newest one to the oldest one and the list is limited to 30 last imports.

The following information can be found in the History tab:

  • Starting date and time
  • Execution time
  • Execution type - full or delta
  • Scope - The type of job import. One type of job is available:
  • Status - see the Synchronization status section for more details
    Message - See the Synchronization status section for more details. The message available in this section indicates the overall health of your job import. To explore details of your job, please click on See logs.
    By clicking on it, you will be able to view a detailed list of job logs per category/product. The errors and warnings available on this page are straightforward, and they will help you understand and fix all potential problems with your import.


Example of an error:

Starting date Status Messages
10/19/2021 12:48:12 ERROR PIM Identifier: "Shoes_2", The product has no label

Please use this functionality to fix all potential errors/warnings in your import. You can access the PIM product concerned by clicking on View on PIM.

Please note that you can use the delta import in order to apply fixes to your import and to preserve the performance of your App.