Configure Hreflang Link Groups for Products in Magento 2

1. Navigate to Catalog > Products
2. Edit any product
3. Scroll to Hreflang Override section
4. Find the Alternate Link Group field

1. Navigate to Catalog > Categories
2. Select any category
3. Scroll to Hreflang Override section
4. Find the Alternate Link Group field

• Use automatic linking (default) - Product/category uses standard ID-based linking
• Create new group - Shows input field to create a new group name

Lists all previously created group names. Select one to add the product/category to that group.

You have different products in each store that should be treated as translations:

These are different products (different SKUs) but represent the same item in different markets.

Step 1: Create group on first product

1. Edit "Blue Running Shoes" (US store)
2. Go to Hreflang Override section
3. Select Create new group from dropdown
4. Enter group name: running-shoes-blue
5. Save product

Step 2: Add other products to the group

1. Edit "Chaussures de Course Bleues" (FR store)
2. Go to Hreflang Override section
3. Select Running-shoes-blue from Existing Groups
4. Save product

Repeat for German product.

Result:

All three products now link to each other with hreflang tags:

<link rel="alternate" hreflang="en-us" href="https://example.com/blue-running-shoes" />
<link rel="alternate" hreflang="fr-fr" href="https://example.fr/chaussures-course-bleues" />
<link rel="alternate" hreflang="de-de" href="https://example.de/blaue-laufschuhe" />

Different category structures per store:

Different category IDs, but same conceptual category.

1. Edit each category
2. Select or create group: mens-clothing
3. Save

All three categories now have hreflang tags linking to each other.

• mens-clothing - descriptive
• running-shoes-blue - specific product type + variant
• electronics-smartphones - category hierarchy
• homepage - standard page type

• group1, test - not descriptive
• english-product - language in name (group is for ALL languages)
• Spaces or special characters - use hyphens

When you assign a product/category to an Alternate Link Group:

• Automatic ID-based linking is disabled for that entity
• Only entities in the same group will link to each other
• Entities without a group continue using automatic linking

The Alternate Link Group field is store view scoped:

• Set different values per store view if needed
• Typically, you'll set the same group name across all store views for the same logical entity

To remove a product/category from a group and return to automatic linking:

1. Edit the entity
2. Select Use automatic linking (default)
3. Save

1. Enable debug mode in module configuration
2. Visit the product/category page with ?show-alternate=1
3. Verify the hreflang tags show correct alternate URLs

Example:

https://example.com/blue-running-shoes?show-alternate=1

Tags not appearing:

• Check that all grouped entities have the exact same group name
• Verify entities are assigned to correct store views
• Clear cache after changes

Wrong products/categories linked:

• Check for typos in group names
• Verify you selected the correct existing group