Orange Collar Media
Orange Collar Media
DOCS
OCMLABS/MODULE-SEO · SYSTEM SETTINGS

Configure meta templates, robots, canonical, hreflang, structured data, and analysis thresholds

  • Magento
  • Adobe Commerce
  • Hyvä

Module settings live at Stores > Configuration > OCM Labs > SEO (section ocmlabs_seo). Config paths are ocmlabs_seo/<group>/<field>. Unless a group says otherwise, every field can be set at default, website, or store view scope. Access requires the OCMLabs_Seo::config ACL resource. The section opens with a Module Information group that shows the installed version.

SEO configuration section in Stores > Configuration, showing the Meta Templates group with its variable list and default templates

Changes to meta templates, robots, canonical, and hreflang settings appear on pages as they are generated. Flush the full page cache after changing them to see the change on pages that are already cached.

General

Default scope only.

FieldConfig pathDefaultDescription
Enable SEO Moduleocmlabs_seo/general/enabledYesNo turns off all storefront output (meta templates, robots, canonical, hreflang, JSON-LD, social tags), the SEO panel, and save-time and nightly scoring. The ocmlabs:seo:rescore command still runs.
Enable SEO Panel on Edit Screensocmlabs_seo/general/panel_enabledYesShows the live score, checklist, and previews on product, category, and CMS page edit screens. The panel needs both this and Enable SEO Module.

Meta Templates

Templates fill in a title or description only when the page has none of its own. See Meta Templates for the variables.

FieldConfig pathDefault
Product Meta Title Templateocmlabs_seo/meta_templates/product_title{{name}} {{sep}} {{store_name}}
Product Meta Description Templateocmlabs_seo/meta_templates/product_description{{name}} at {{store_name}}. {{attribute:short_description}}
Category Meta Title Templateocmlabs_seo/meta_templates/category_title{{name}} {{sep}} {{store_name}}
Category Meta Description Templateocmlabs_seo/meta_templates/category_descriptionShop {{name}} at {{store_name}}.
CMS Page Meta Title Templateocmlabs_seo/meta_templates/cms_page_title{{name}} {{sep}} {{store_name}}
CMS Page Meta Description Templateocmlabs_seo/meta_templates/cms_page_description(empty)
Separatorocmlabs_seo/meta_templates/separator|

An empty template leaves Magento’s own value in place.

Robots

Each field offers Use Default (inherit), index, follow, noindex, follow, and noindex, nofollow. Use Default leaves Magento’s own robots value in place. A robots value set on an individual product, category, or page always wins.

FieldConfig pathDefaultApplies to
Catalog Search Resultsocmlabs_seo/robots/search_resultsnoindex, followCatalog search result pages
Filtered Category Pagesocmlabs_seo/robots/filtered_categorynoindex, followCategory pages with layered navigation filters applied
Paginated Category Pagesocmlabs_seo/robots/paginated_categoryUse Default (inherit)Category pages beyond page 1

Canonical

FieldConfig pathDefaultOptions
Manage Canonical Tagsocmlabs_seo/canonical/enabledYesWhen No, Magento’s own canonical settings apply untouched.
Product Canonical URLocmlabs_seo/canonical/product_modeNo category path (product URL)No category path, Shortest category path, Default (first) category path
Filtered Category Canonicalocmlabs_seo/canonical/filtered_categoryUnfiltered category URLUnfiltered category URL, Self (filter parameters kept)
Paginated Category Canonicalocmlabs_seo/canonical/paginated_categorySelf (page parameter kept)Self (page parameter kept), First page of the category

See Robots & Canonical.

Hreflang

FieldConfig pathDefaultScopeDescription
Enable Hreflang Alternatesocmlabs_seo/hreflang/enabledNoDefault, website, store viewAdds alternate links for the other store views that show the same product, category, or CMS page.
x-default Store Viewocmlabs_seo/hreflang/x_default_storeNone (no x-default alternate)Default onlyThe store view the x-default alternate points to. One value for all store views, so every page lists the same alternates.
Locale Overrideocmlabs_seo/hreflang/locale_override(empty)Default, website, store viewA language code used for this store view instead of its locale, for example en-GB or de. Invalid values are ignored.

See Hreflang.

Structured Data

FieldConfig pathDefaultDescription
Enable JSON-LDocmlabs_seo/structured_data/enabledYesOutputs Product, BreadcrumbList, Organization, and WebSite structured data.
Brand Attribute Codeocmlabs_seo/structured_data/brand_attributemanufacturerProduct attribute used for the schema brand.
GTIN Attribute Codeocmlabs_seo/structured_data/gtin_attribute(empty)Product attribute holding the GTIN, EAN, or UPC. Empty omits it.
MPN Attribute Codeocmlabs_seo/structured_data/mpn_attribute(empty)Product attribute holding the manufacturer part number. Empty omits it.
Organization Nameocmlabs_seo/structured_data/organization_name(empty)Empty uses the store name.
Organization Logoocmlabs_seo/structured_data/organization_logo(empty)Path of an image inside pub/media, for example logo/default/logo.png. Other values are ignored.
Organization Profile URLsocmlabs_seo/structured_data/organization_same_as(empty)Social and directory profile URLs, one per line. Only absolute http or https URLs are used.

See Structured Data & Social.

Analysis

The thresholds behind the checklist. See SEO Panel & Checks for how each one is used.

FieldConfig pathDefault
Keyword Density Minimum (%)ocmlabs_seo/analysis/density_min0.5
Keyword Density Maximum (%)ocmlabs_seo/analysis/density_max2.5
Minimum Words, Productsocmlabs_seo/analysis/content_min_product150
Minimum Words, Categoriesocmlabs_seo/analysis/content_min_category100
Minimum Words, CMS Pagesocmlabs_seo/analysis/content_min_cms_page300
Title Length Pass, Minimumocmlabs_seo/analysis/title_min30
Title Length Pass, Maximumocmlabs_seo/analysis/title_max60
Title Length Warning, Minimumocmlabs_seo/analysis/title_warn_min20
Title Length Warning, Maximumocmlabs_seo/analysis/title_warn_max70
Description Length Pass, Minimumocmlabs_seo/analysis/description_min120
Description Length Pass, Maximumocmlabs_seo/analysis/description_max160
Description Length Warning, Minimumocmlabs_seo/analysis/description_warn_min70
Description Length Warning, Maximumocmlabs_seo/analysis/description_warn_max180
Flesch Reading Ease, Passocmlabs_seo/analysis/flesch_pass60
Flesch Reading Ease, Warningocmlabs_seo/analysis/flesch_warn30
Long Sentence Threshold (words)ocmlabs_seo/analysis/sentence_max_words20
Long Sentences Allowed (%)ocmlabs_seo/analysis/sentence_max_share25
Paragraph Length Maximum (words)ocmlabs_seo/analysis/paragraph_max_words150

Length thresholds are in characters. Between the warning and pass limits a check shows a warning; outside the warning limits it fails. The density minimum cannot exceed the maximum, and saving such a pair is rejected.