Synchronization page

The Synchronization page allows you to manage connections between your products, collections, and other resources across all connected Shopify stores. Hreflang Manager offers powerful automatic matching based on SKU or Barcode, while a manual synchronization option is present, as well as the CSV Import and Export feature. Utilize these for bulk updates, especially if your store data is not perfectly structured.

Automatic synchronization

Once a second or any further store is added to the application, the automatic synchronization process starts by default. Automatically, the items in your stores can be matched by different mapping keys:

• Products mapping: sync by Barcode, SKU and handle.
• Collections, pages, blogs, and articles mapping: sync by handle only.

The synchronization result is usually available in several minutes and depends on the number of items and stores.

Synchronization results (statuses)

When the sync is completed, its result is available in each connection row. There, you can see if the items have been synced fully, partially, or are non-synced.

Synchronized

Full sync means that a particular item (a product, page, etc) has been synced with the same item on each store connected to the Hreflang Manager app.

Partial sync

Partial sync means that a particular item (a product, page, etc) hasn’t been synced with the same item on at least one store. If you receive such a result, you might check this item’s availability at each store in the Shopify admin, leave it without any changes, or sync it manually.

Non-sync

Non-sync means that a particular item (a product, page, etc) hasn’t been mapped with the same item on all other stores. If you receive such a result, you might check this item’s availability at each store in the Shopify admin, leave it without any changes, or sync it manually.

Refresh of each resource type to the latest version (Product, Collection, etc.)

In case one of your store’s or all your store’s item lists has been updated: new products have been added, articles have been edited, etc., you might want to update this info in the Hreflang Manager application to have the up-to-date hreflang tags on your stores.

Important to know:

• Products and collections updates or creation events are being delivered to the Hreflang Manager app right away and are reflected automatically in the app without any manual actions.
• Pages, blogs, and articles updates or creation events are not reflected in the Hreflang Manager app automatically due to Shopify limitations. To update the item list and info to the latest version, use the “Refresh” button in the respective tab.
  

Manual synchronization

There is a possibility to map items across your stores manually. It can be done following the next steps:

1. Go to the Synchronization page.
2. Find any product row that contains non-synced elements.
3. Press the Select Product button, and start typing an item’s name, SKU, or barcode in the modal window. A product list with matched items should come up.
4. Select the required item in the field and press the Save button. The item’s status should be updated for all the stores connected to the app.

You can also edit the automatically mapped connections in case there are better pairs for the items than those that were synchronized by the app.

To break the connection, follow these steps:

• Navigate the necessary connection on the Synchronization page.
• On the incorrectly added item, press the Delete button.
• Save the changes.

CSV Export and Import

Also, kindly note that the CSV Import and Export functionality is currently in Beta testing, and we’re still working on improving it, so in case you have any feedback or ideas on upgrading it, you’re welcome to share it with our Support team at [email protected].

Bulk management with CSV

This feature allows you to export your current connections into a CSV file, edit them outside the Hreflang Manager application, using product handles to map the items, and then import them back into the application to apply changes.

This feature is useful for stores with some data inconsistency between the regional stores and their objects - Products, Collections, etc.

How to export connections:

1. Navigate to the Synchronization page in the Hreflang Manager application.
2. Click the Export button located at the top right of the page.
3. In the pop-up window, select the resource type you want to export (e.g., Product, Collection, Page, etc.).
4. Click the Export [Resource] button. A CSV file containing your current mapping will be downloaded to your device.

Understanding the file structure:

If you are unsure how to format your data for import, you can download a showcasing file:

1. Click the Import button on the Synchronization page.
2. Click the "Download sample CSV" link.
3. This sample file serves as a visual guide to show you exactly how the headers and handles should appear, so after your file import, the synchronization performs correctly.

How to edit the file:

1. Open the downloaded CSV file in a spreadsheet editor like Google Sheets or Microsoft Excel.
2. The first row (headers) lists your connected stores.
3. Each following row represents a connection. To connect items, place their respective handles in the same row under the appropriate store column.
4. Save the file in .csv format once your edits are complete.

How to import connections:

1. Navigate to the Synchronization page in the Hreflang Manager application.
2. Click the Import button located at the top right of the page.
3. Select the resource type that matches your file.
4. Upload your edited CSV file.
5. Click the Upload button.

Once uploaded, the app will begin the "rematching" process. You will see a temporary status screen. Click the Refresh button on this screen to check if the synchronization is complete.

Important rules for data processing

• Handle matching: The system matches your items strictly based on their Shopify handles.
• Invalid handles: If the file contains a handle that does not exist in your store, the system will simply ignore that specific row and continue processing the rest of the file.
• Duplicate handles: If the same handle appears in multiple rows of your CSV file, the system will only accept the connection from the last row where that handle was mentioned.
• Unchanged data: If you import a file without making any changes to some specific connections or the file in general, the previous synchronization statuses will remain exactly as they were.
• Incorrect file: In case you import a file that is irrelevant to the Synchronization in the Hreflang Manager app functionality or contains a list of stores in the first line, that is not relevant to the store where you’re uploading the file, the application will show you an error. Review the file and upload the respective one.

FAQ about Synchronization page