Installation instruction

Select a pricing plan (or start a free trial) and complete the 3-step installation process to start using the app:

  1. Pricing. In this step, it is required to select a pricing plan or to start a free trial.
  2. Connect at least two stores to the app:
  3. Set up. In this step, it is required to select the language and region for each connected store.
  4. Install the app in theme: add the {% render 'hreflang-main' %} snippet to the live theme and paste the code before the closing tag of the Layout/theme.liquid file. The sync info of all your stores will be displayed at the top of the Installation page once these 3 steps are completed. From now on, the app is ready to work.

How to connect stores to the app (Step 1)

To connect at least two stores, the following needs to be done:

  1. Install the app in the store that is supposed to be the main one.
  2. On the Pricing page, select the app plan or start the free trial.
  3. On the Installation page, select the “This is my main store” option in Step 1.
  4. Copy the code from the secondary store:
    • Install the app to the store that is supposed to be the secondary one.
    • On the Pricing page, select the pricing plan or start the free trial.
    • On the Installation page, select the “This is my secondary store” option in Step
    • Copy the code from the field above.
  5. Paste the code from the secondary store to the empty field in your first store and press the Add button.
  6. Accomplish Step 1 by pressing the “I've connected my second store” button. If the code is correct, you will proceed to Step 2.

How to set up stores (Step 2)

The hreflang attribute identifies the language (in ISO 639-1 format) and optionally a region (in ISO 3166-1 Alpha 2 format) of an alternate URL. The store language isn’t connected with the region by default.

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.

How to add the app snippet (Step 3)

Step 3 is divided into two parts:

  1. Adding 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. Paste 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.

How to uninstall the app

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

  • Go to your store’s Admin Panel->Apps.
  • Find the Hreflang Manager app in the app list.
  • Press the Delete button in front of the app.