Move from staging to production
This section provides guidance on how to transition from the staging PIM to the production PIM with the Akeneo App for Shopify. Depending on your setup, there are different approaches to ensure smooth product synchronization and avoid product duplication in your Shopify store.
Properly managing the connection between your staging and production environments is crucial to avoid product duplicates in your Shopify store. If duplicates occur in production, you will need to manually delete them from the Shopify store.
Separate databases for staging and production: please note that you access an app that can be connected to your staging and production PIMs. The app has its database with distinct product links for each PIM environment it's connected to. Therefore, product links created and stored in the app connected to your staging PIM will not be available in the database of the app connected to your production PIM.
Different scenarios for transitioning to production
Scenario 1: Using a different Shopify store for production (recommended)
On your production PIM, if you plan to connect the app to a new or different Shopify store, follow these steps:
- Set up your new Shopify store: Connect the app to your new Shopify store and ensure it is properly configured (step-by-step tutorial here).
- Start synchronizing products: Once the store is connected, you can begin synchronizing products from your Akeneo PIM. Since the store is empty, there will be no issue with duplication.
You can see how synchronization works on this page.
We recommend using a separate Shopify store for your production as it simplifies the transition, as there are no existing products to link. You can freely synchronize products without worrying about duplication.
Scenario 2: Switching the same Shopify store from staging to production (not recommended)
If you used a Shopify store for the app connected to your staging PIM during the staging phase and want to connect the same Shopify store to the app connected to your production PIM, follow these steps to ensure proper product synchronization without duplication:
- Enable the pre-existing catalog feature: In the app, you must enable the pre-existing catalog feature (step-by-step tutorial here). This feature links the products that already exist in Shopify (created during the staging phase) to their corresponding PIM products in the production PIM.
- Synchronize products: When you perform the synchronization in production, the app will use this feature to match the Shopify products with their PIM counterparts, preventing duplicates.
You can see how synchronization works when the pre-existing catalog feature is enabled on this page.
What to do if duplicates appear after synchronization without the pre-existing catalog feature?
If you've already launched a synchronization without activating the pre-existing catalog feature, and this resulted in duplicate products, you have two options to fix it:
- Delete all products and restart synchronization: Manually delete all products from your Shopify store and restart synchronization from the app connected to your production PIM. This will recreate the products without duplicates.
- Delete duplicates created by the app connected to your staging PIM: If you prefer not to delete everything, you can manually remove the duplicate products created during the staging phase.
Please note that you don't need to activate the pre-existing catalog feature for these two options.