Shopify Hreflang Manager App Installation page showcase

Installation instruction

Install the app to stores you want to sync between each other, choose a pricing plan (or start a free trial). After that, 3 steps are needed to be done:

  1. Establish the main and secondary store(s).
  2. Select the language and region for each connected store.
  3. Install the app code to your stores.

Link stores between each other (Step 1)

After the app is installed in at least two stores and selected the pricing plan, you need to connect these stores between each other.

  1. 1.1Establish which store will be the main one and which store(s) will be the secondary one. You can manage all connected stores from the main store. You can change the main store later on Dashboard.
  2. 1.2Go to the secondary store. On the Installation page, select the “This is my secondary store” option in Step 1. Copy the code from the field above. Go to your main store. Paste the code from the secondary store to the empty field in your Main store and press Add.
  3. 1.3If you have more than two stores, repeat Step 1.2 for each store remaining. If the stores are linked between each other, you will proceed to Step 2.

Set up the store's language (Step 2)

During installation, the main store is already chosen in Step 1. It is only required to select a language and, optionally, a region for each store.

There are several settings for every store connected that need to be set up on Step 2:

Store language This is the required option. A language can be chosen from the language dropdown. During installation, it is required to choose a language for each added store to proceed to the next step. You can add several languages and regions to each store in Advanced settings by pressing Add and choosing the required options from the dropdown.

Store country/region.This is optional. A region can be chosen from the country dropdown. If chosen, the store will be displayed for a particular region only.

Main store (x-default). When no language/region that is defined in the app matches the users’ browser settings, they will be redirected to this store. For example, if a user’s browser settings are defined as Spanish-Mexico, and there are no stores added to the app with these settings, these users will be redirected to the x-default store. The main store is chosen during onboarding and can be changed later.

Main language store (en/fr/es…). This is a store type, which is independent of the region (i.e. store in French for both France and Canada customers). By default, the first store on a particular language is considered as the main language store in the app. This status can be changed after connecting the next stores.

If your store(s) use translations or have Weglot app installed, proceed with this instruction once you've done Step 3.

These settings can be changed later on the Stores page.

Also, see how you can change the language/domain settings of your Shopify store.

Adding the app code to live theme (Step 3)

Step 3 is divided into two parts:

  1. 3.1Adding the app snippet to your theme. It can be done by pressing the Add snippet button. The snippet then will be added to the live theme of your store.
  2. 3.2Paste the {% render 'hreflang-main' %} code snippet to the layout/theme.liquid file. It can be done automatically by pressing the Add code button, or manually by copy-pasting the code to the required file.

Please note that Step 3 should be performed for every store that is about to be connected to the app.

Uninstall Hreflang Manager

To uninstall the Hreflang Manager app, it is needed to follow the next steps:

  1. On Dashboard, press Disconnect near the connected store(s). Thus, you will delete the app code from stores.
  2. Go to your store’s app list and find Hreflang Manager there. Press the Delete button in front of the app

There is a possibility that the app code remains after uninstalling Hreflang Manager.

You can follow these steps to fully remove Hreflang Manager App code from the store:

  1. Go in your Admin Panel -> Online Store -> Themes -> Actions -> Edit Code
  2. Open the theme.liquid file
  3. Find and remove the code {% include "gwa-hreflang" %} OR {% render "gwa-hreflang" %}
  4. Save the changes.
  5. In the search bar, enter the word "hreflang"
  6. Open the gwa-hreflang.liquid file and click Delete.