Parameters

1. Credential parameters

 
  • In the Parameters tab, you will need to enter the API Key and the API Access Token obtained in the previous steps.
  • You will also need to specify your shop name — this is the name assigned to your company in Shopify. Example: shopname.myshopify.com
  • Then, click the Connect with Shopify button.
  • If any credential data is incorrect, the following message will appear:
     
  • If the connection is successful, the following pop-up window will appear.
 

2. Locations Parameter

 
  • This setting allows you to select the store location to synchronize with.
  • If you want to sync multiple locations, you must create a separate channel for each one.
 

3. Overwrite Stock When Updating

 
  • This option determines whether stock levels should be overwritten during updates.
  • During the first synchronization, stock values will always be sent.
  • If set to Yes, stock will be updated in the selected location(s) every time a product is edited in Sales Layer.
  • This setting controls whether stock will be overwritten in future updates.

Note: For the first synchronization of a shop, stock is always included.

4. Disable Deletions

Warning: Use this parameter with extreme caution.

  • This parameter is intended for testing purposes, specifically in visible mode, to allow testing with targeted items.
  • Its use is recommended only in coordination with Sales Layer support for debugging, solving incidents, or testing new features without impacting other products — and only in accounts that do not have a staging store. We highly recommend using STAGING for this purpose whenever possible.

IMPORTANT: Enabling this parameter requires configuring the “status” field in Variants.

Yes:

  • This parameter only applies when field export items with status is:
    • Only visible
    • Visible and invisible
    • Visible and draft
  • It does NOT work when field export items with status is set to:
    • All
  • When its configuration is applied to the synchronization, it limits the communication between the Sales Layer API and the connector regarding deletions. So, it allows you to update or filter specific items only, without triggering deletions or deactivations of other items.
  • Once an item is marked for update and stored in the internal table, its state will never change again unless a status field is explicitly used to control it.
  • Example: You can apply a filter to isolate a specific item without exporting others that don’t match the applied filters or conditions for deletion.

No:

  • This is the default and recommended value.
  • Items can be deactivated.
  • Variants can be deleted if they are no longer present or valid.
 

5. Export items with status
 

  • Only visible: This option will allow you to create or modify items only in this status. If you have changed the status on a group of items from visible to another status, the connector will change these products' status to archived, if there are collections it will eliminate the link to its products and visibility in-store or if there are variants it will eliminate them in Shopify.
     
  • All: This option will allow you to create or modify all items. In Shopify products will synch as active, collections will be sent as visible and variants that have no status in Shopify will also be included in the sync, regardless of their Sales Layer status.
     
  • Visible and invisible: This option will allow you to create or modify items only in these statuses. If you have changed the status on a group of items from visible or invisible to draft, the connector will change the item status to archived, if there are collections it will eliminate the link to its products and visibility in-store or if there are variants it will eliminate them in Shopify.
     
  • Visible and draft: This option will allow you to create or modify items only in these statuses. If you have changed the status on a group of items from visible or draft to invisible, the connector will change the item status to archived, if there are collections it will eliminate the link to its products and visibility in-store or if there are variants it will eliminate them in Shopify.
 

6. Include empty categories

 

If set to Yes, the connector will include categories that have no products.
A category is considered empty if:

  • It has no products at all, or
  • All its products have a status that is excluded by the connector’s selected status filter.
 

7. Language to connect

 

You can select one or more languages based on the settings in your PIM.
If you select multiple languages and have multi-language fields in your catalog, the channel will send all translations of those fields to Shopify, according to your selection.

Once all parameters have been configured, click the Continue button in the lower-right corner. The synchronization will launch automatically after saving all tabs.

 

8. Refresh Button

 

Important:

  • When refreshing the connector using this option, item deletions or deactivations are not exported.
  • This functionality is designed to send all visible content, with the goal of fully restoring the catalog.
  • This functionality should not be used to make synchronization faster. On the contrary, since it sends the entire catalog, the process takes considerably longer than usual.

Example: The store has been wiped, and you need to republish all visible content.

  • If a full synchronization must be launched, meaning to sync all products, previous and new, all fields, whether they’ve been modified or not, apart from selecting this option, you could use the “Force refresh” button on top of “Parameters” tab.
  • However, if you use this option, you must be aware that it will trigger the export of your entire catalog, including multi-language fields, images, formulas, etc. This significantly increases synchronization duration compared to a scheduled incremental sync.
  • Forcing the connector does not ensure immediate synchronization, as it will depend on the existing process queue.
     
Initial configuration
Output data