Quick Start Guide

This is the quick start guide for the Alternate Hreflang Extension. We'll get you up and running in about 5 minutes. This covers the basics - enabling the module, configuring which stores link together, and testing your first hreflang tags. If you're new to hreflang or just want to get started quickly, you're in the right place.

5 steps to get it working.

Prerequisites

• Module installed via composer
• Cache cleared
• Multiple store-views configured in Magento
• Basic understanding of multilingual/multi-regional stores

Step 1: Enable the Extension

Navigate to: Stores → Configuration → Magmodules → Alternate Hreflang → General

Configure:

• Enabled: Yes

Step 2: Configure Store Targeting

Navigate to: Stores → Configuration → Magmodules → Alternate Hreflang → Targeting Settings

Click "Add Row" for each store-view and configure:

Important: All stores in the same group (e.g., Group 1) will link to each other with hreflang tags.

Step 3: Enable Page Types

Navigate to: Stores → Configuration → Magmodules → Alternate Hreflang → Alternate Hreflang Configuration

Enable hreflang on:

• Enable on Homepage: Yes
• Enable on Product Pages: Yes
• Enable on Category Pages: Yes
• Enable on CMS Pages: Yes

Step 4: Enable Canonical Integration

In the same configuration section:

• Enable Hreflang Only on Canonical URLs: Yes

This prevents hreflang tags from appearing on duplicate/filtered pages.

Step 5: Test Your Configuration

1. Enable debug mode:

   • Alternate Hreflang Configuration → Enable Debug Mode: Yes

2. Visit any page and add ?show-alternate=1 to the URL:

   https://example.com/?show-alternate=1
   https://example.com/product-name?show-alternate=1
   

3. Verify hreflang tags appear:

   <link rel="alternate" hreflang="en-us" href="https://example.com/product" />
   <link rel="alternate" hreflang="fr-fr" href="https://example.fr/produit" />
   <link rel="alternate" hreflang="de-de" href="https://example.de/produkt" />
   

4. Disable debug mode before going to production.

Verification Checklist

✅ Module is enabled
✅ Store targeting is configured with language codes
✅ At least one page type is enabled
✅ Canonical integration is enabled
✅ Hreflang tags appear when testing with ?show-alternate=1

Need More Help?

Documentation:

• All Help Articles - Complete documentation overview

Support:

• Contact Support - Get help from our team