Troubleshooting SEO Meta Templates

Symptoms:

• Product page still shows original meta tags
• Template works in preview but not on the frontend

Solution:

1. Check Override Mode — if set to "Fallback Only", the product's existing meta tags won't be overwritten. Clear the product's meta title/description fields or switch to "Always Override"
2. Verify the template's store view includes the store you're testing on
3. If using conditions, test the product matches by entering the SKU in the preview
4. Check template priority — a higher-priority template (lower number) with no matching template fields might be winning
5. Clear full page cache after making changes

Prevention:

• Use the preview feature to verify templates match specific products before relying on the frontend

Symptoms:

• Meta title shows "{name}" literally, or variables resolve to empty strings
• Template like {name} - {color} produces "Widget - "

Solution:

1. Check the variable name is correct — it must match the product attribute code exactly
2. For custom attributes, ensure the attribute has a value set for that specific product
3. For {brand}, the module reads the manufacturer attribute — make sure it's populated
4. Use optional wrapping for unreliable variables: {name}[ - {color}] instead of {name} - {color}

Prevention:

• Always wrap optional variables in square brackets
• Use the preview feature with a real SKU to check which variables resolve

Symptoms:

• Meta title or description is cut off mid-sentence
• Characters seem to disappear from the end

Solution:

1. Check Title Max Length and Description Max Length in configuration
2. The module truncates at word boundaries — a 60-character limit may result in fewer characters if the next word would exceed the limit
3. Increase the max length if your templates consistently produce longer text

Prevention:

• Keep templates concise, especially for titles
• Test with the preview to see actual output length

Symptoms:

• A product gets meta from the wrong template
• Changes to one template don't seem to take effect

Solution:

1. Check priorities — templates are evaluated from lowest number (highest priority) to highest number
2. The first template that matches (correct entity type, store view, and passes conditions) wins
3. If two templates have the same priority, results are unpredictable — use different priority values
4. Check conditions on each template — a template without conditions matches everything

Prevention:

• Use increments of 5 or 10 for priorities (5, 10, 15, 20)
• Put specific/conditional templates at higher priority (lower number) than generic fallbacks

Symptoms:

• Product template with SKU condition applies to all products
• Conditional template seems to be ignored

Solution:

1. Conditions only work for Product entity type — Category and CMS Page templates ignore conditions entirely
2. After saving conditions, verify they're stored correctly by re-opening the template
3. Test the condition by entering a matching and non-matching SKU in the preview

Prevention:

• Always test conditions with the preview feature before saving
• Remember that a template without conditions matches all products of that entity type

Symptoms:

• Meta title and description update correctly but H1 stays the same

Solution:

1. Make sure the H1 Template field is filled in — it's separate from the meta title template
2. Some themes override the H1 heading with custom blocks — the module plugins into Magento\Theme\Block\Html\Title, which not all custom themes use
3. Clear full page cache

Prevention:

• Test with a default Magento theme (Luma) to isolate whether the issue is theme-related