On this page
Shopify Hreflang Manager App Installation page showcase

Installation instruction

Having app installed in stores and a pricing plan chosen, finish the setup in 3 simple steps:

  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 your Shopify stores between each other (Step 1)

After the app is installed in at least two Shopify stores and the pricing plan is selected, 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:

Shopify 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 defined language/region in the app matches the users’ browser settings, they will be redirected to this store. For example, if a users' browser settings are defined as Spanish-Mexico, and you don't have a Spanish-Mexico Shopify store, 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 French and Canadian 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, return to Step 2.

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.2 Paste the {% include "gwa-hreflang" %} code snippet to the layout/theme.liquid. It can be done automatically by pressing the Add code to theme 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.