1. Home
  2. Docs
  3. Magento 2 SEO Extensions
  4. Magento 2 SEO Extension
  5. User Guide

User Guide

1. SEO Extension for Magento 2 Overview

Magento 2 SEO Extension by BSSCommerce is the complete SEO package to maximize the effectiveness of Search Engine Optimization for your e-commerce business. This comprehensive SEO extension for Magento 2 includes all crucial tools for a great SEO performance such as Canonical Tags, Hreflang Tags, Robot file settings. Furthermore, you will get all features of 4 other Magento 2 extensions (Meta Tags – Rich Snippets – XML Sitemap and HTML Sitemap) fully-integrated in the package.

2. How Does SEO Extension for Magento 2 Work?

Please go to Store ⇒ Configuration ⇒ BSSCOMMERCE and start configuration.

2.1 In Google XML Sitemap

To configure XML sitemap for your Magento 2 store, please follow these 2 steps:

  • Step 1: Configure the extension settings as your wishes at Stores ⇒ Configuration ⇒ BSSCOMMERCE ⇒ Google XML Sitemap.
  • Step 2: Create a new XML sitemap at Marketing ⇒ Google XML.

First, we will show you how to configure the feature settings.

2.1.1 Homepage Options

Homepage Option

In Show Homepage: Choose Yes to show homepage in the XML sitemap, otherwise choose No to hide it.

In Frequency: Choose the frequency for the search engine crawlers to index Homepage. The options are: Always – Hourly – Daily – Weekly – Monthly – Yearly – Never.

In Priority: Choose the priority for the search engine crawlers to index Homepage. Valid values range from 0.0 to 1.0.

In Enable Modify: Choose Yes to show the time of the latest modify of the homepage in XML sitemap file, otherwise choose No to hide it.

2.1.2 Categories Options

Categories Options

In Frequency: Choose the frequency for the search engine crawlers to index category pages. The options are: Always – Hourly – Daily – Weekly – Monthly – Yearly – Never.

In Priority: Choose the priority for the search engine crawlers to index category pages. Valid values range from 0.0 to 1.0.

In Disable Category an All Products on Category: Fill in the ID of categories you want to hide from sitemap (separated by a coma). All products in selected categories will be hidden as well.

2.1.3 Product Options

Product Options

In Enable Path: This setting depends on the Use Categories Path for Product URLs of your site. Please go to Stores Configuration Catalog CatalogSearch Engine Optimization Use Categories Path for Product URLs.

  • If the setting is No, you will choose No at Enable Path.
  • If the setting is Yes, you will choose Yes at Enable Path.

In Frequency: Choose the frequency for the search engine crawlers to index product pages. The options are: Always – Hourly – Daily – Weekly – Monthly – Yearly – Never.

In Priority: Choose the priority for the search engine crawlers to index product pages. Valid values range from 0.0 to 1.0.

In Add Images to Sitemap: Choose how you want to add the images of products into your XML sitemap. There are 3 options:

  • No: Do not add images to the sitemap.
  • Base Only: Only add base images of products into the sitemap.
  • All: Add all images of products into the sitemap.

In Disable Product Type: You can choose to hide all products belong to (a) product type(s) from the sitemap.

In Disable Product: Fill in the ID of products you want to hide from sitemap (separated by a coma).

2.1.4 CMS Page Options

CMS Page Options

In Frequency: Choose the frequency for the search engine crawlers to index CMS pages. The options are: Always – Hourly – Daily – Weekly – Monthly – Yearly – Never.

In Priority: Choose the priority for the search engine crawlers to index product pages. Valid values range from 0.0 to 1.0.

In Disable CMS Link: Choose CMS links to be disabled from the XML Sitemap.

2.1.5 General Setting

General Setting

In Enables: Choose Yes to enable frequency setting for the extension to update the sitemap, otherwise choose No to disable it.

In Frequency: Choose the frequency for the extension to update the sitemap. The options are: Daily – Weekly – Monthly.

In Error Email Recipient: Choose the recipient to receive error email once there is an error.

In Error Email Sender: Choose the name of the sender displaying in error email.

In Error Email Template: Choose the template for error email.

2.1.6 Sitemap File Limit

Sitemap File Limits

In Divide Sitemap: There are 4 options for dividing sitemap:

  • None: Do not divide sitemap.
  • Date: Divide site map by the last modified date of the products.
  • Category: Divide site map by the products in the same category.
  • Manufacture: Divide site map by the products with the same manufature.

Note: Sitemap is divided following the maximum number of URLs per file and maximum file size settings.

In Maximum No of URLs per file: Maximum number of URLs in an XML sitemap file.

In Maximum File Size: Maximum file size in byte.

2.1.7 Search Engine Submission Settings

In Enable Submission to Robots.txt: Choose Yes to display XML Sitemap URL in Robots.txt file, otherwise choose No.

2.1.8 Additional Link List

In Frequency: Choose the frequency for the search engine crawlers to index additional links. The options are: Always – Hourly – Daily – Weekly – Monthly – Yearly – Never.

Additional Link List

In Priority: Choose the priority for the search engine crawlers to index additional links. Valid values range from 0.0 to 1.0.

In List of Additional Links: Fill in the list of additional links to be shown in the sitemap.

2.1.9 Generate Sitemap

After finishing setting up the extension, admins will generate a sitemap which will be created following the above settings.

Please go to Marketing ⇒ Google XML Sitemap, select Add Sitemap to create a new sitemap.

Generate Sitemap

In File Name: Choose the name for the sitemap. The format is nameofthesitemap.xml.

In case you are already using an XML sitemap, there would be 2 options at this point:

  • Create a new sitemap with a different name from the old sitemap. You can submit both sitemap on Google Search Console and the crawler will read both file.
  • Delete the old sitemap then create a new one with the same name as the old. The new sitemap following the module setting will be over written on the search console and will not affect SEO.

In Path: The default path is “/”. If you want to use a different path, you have to create a new folder at the backend.

Choose Save.

New Site Map

After saving the sitemap, click Generate for the sitemap to be created following the module settings.

Google XML Site Map

2.1.10 Edit and Delete Sitemap

Please go to Marketing Google XML Sitemap, selectthe sitemap you want to edit or delete.

Edit and Delete Site Map

In the Name, Path and Store View section, you can change the name, path and store view of the XML Sitemap. Click Save and Generate to finish the change.

Click Deleteto delete the sitemap.

To reset the sitemap, click Resetand then click Save. Back to the main section, and click Generate to finish.

2.2 In HTML Sitemap

2.2.1 General

In Enable, choose Yes to enable the feature, otherwise choose No.

In Title of Site, choose the title for the sitemap.

In Session Order, fill in the order of sessions to be displayed. Please fill in all 4 items separated by a coma. ID of sessions as below:

  • 1: Product List
  • 2: Store View List
  • 3: Additional Link List
  • 4: Category and CMS Page List

General Setting

2.2.2 Search Engine Optimization

In Meta Title, choose the meta title for your sitemap.

In Meta Keywords, choose the meta keywords for your sitemap.

In Meta Description, write meta description for your sitemap.

Search Engine Optimization

2.2.3 Product List

In Show Product Link, choose Yes to show product links in the sitemap, otherwise choose No.

In Title of “Product List”, choose the title for the product list session in the sitemap.

In Sort Product by, choose among DESC for descending or ASC for ascending.

In Arrange Product by, choose Name/Date/Price to sort product links.

In Maximum Products Displayed on Sitemap, choose the maximum for the number of product links to be shown. The limit number you can fill in is 50000.

Product List

2.2.4 Store List

In Show Store View Link, choose Yes to show store view links in the sitemap, otherwise choose No.

In Title of “Store View List”, choose the title for the store view list session in the sitemap.

Store List

2.2.5 Category List

In Show Category Link, choose Yes to show category links in the sitemap, otherwise choose No.

In Title of “Category List”, choose the title for the category list session in the sitemap.

In Disable Category, fill in IDs of categories you want to hide inthe sitemap (separated by a coma). For example: 1,2,5,9,23,45,77.

Category List

2.2.6 Additional Link List

Additional Link List

In Title of “Additional Link List”, choose the title for the additional link list session in the sitemap.

In Open Additional Link in a New Tab, choose Yes to open additional links in a new tab, otherwise choose No.

In List of Additional Links, choose the links and the anchor you want to display for each link. Follow this example: [http://yourlink1.com][Anchor Text 1].

2.2.7 CMS Link List

In Show CMS Link, choose Yes to show CMS links in the sitemap, otherwise choose No.

In Title of “CMS List”, choose the title for the CMS link list session in the sitemap.

In Disable CMS Link, choose the CMS links you want to hide from the sitemap. Hold Ctrl when choosing multiple options.

CMS Link List

2.3 In Rich Snippets

2.3.1 General Options

General Option

In Enable: Choose Yes to enable the feature or choose No to disable it.

2.3.2 Site Structure

In Sitename in Search Result: Choose Yes to show the website name you assign in the search result, otherwise choose No. If you choose No, the Show Search Box in Search Result will be disabled.

Site Structure

In Website Name: Choose the name for your website to be displayed in the search result.

In Website Description: Write a description for your website to be displayed in the search result.

In Website Image: Choose an image for your website to be displayed when sharing via Open Graph on Facebook and via Twitter Card on Twitter.

In Show Search Box in Search Result: Choose Yes to show a specific search box for your website, otherwise choose No.

In Twitter Username: Enter Twitter Username with @ to support Twitter card.

In Website Image: Choose Yes to show breadcrumbs (show navigation path) of product page instead of the regular URLs in the search result, otherwise choose No.

2.3.3 Local Business

Local Business

In Enable Local Business: Choose Yes to show the following information of your website in the search result, otherwise choose No.

In Name of Business: Choose the name for your business to be displayed in the search result.

In Logo: Choose a logo of your business.

In Email: Enter your business email.

In Telephone: Enter your business phone.

In Locality: Enter the locality of your business.

Local Business Setting

In Price Range: Enter the price range of your business.

In Street Address: Enter your business street address.

In Country: Enter country of your business in two capital letters following ISO 3166-1 alpha-2 country code.

In Post Code: Enter your business post code.

In Social Profile Links: Enter your business social profile links. Please enter one link per line.

2.3.4 Product Options

In Show Name: Choose Yes to show the product name in the search result, otherwise choose No. If you choose No, all the following settings will be disabled.

In Show SKU: Choose Yes to show the product SKU in the search result, otherwise choose No.

In Show Image: Choose Yes to show the product image in the search result, otherwise choose No.

Product Options

In Show Description: Choose Yes to show the product description in the search result, otherwise choose No.

In Show Review: Choose Yes to show the product review in the search result, otherwise choose No.

In Show Avg. Rating: Choose Yes to show the product average rating in the search result, otherwise choose No.

In Show Price: Choose Yes to show the product price in the search result, otherwise choose No.

In Show Availability: Choose Yes to show the product availability (in stock/out of stock) in the search result, otherwise choose No.

2.3.5 Category Options

In Show Name: Choose Yes to show the category name in the search result, otherwise choose No. If you choose No, all the following settings will be disabled.

In Show Description: Choose Yes to show the category description in the search result, otherwise choose No.

In Show Image: Choose Yes to show the category image in the search result, otherwise choose No.

Category Options

2.3.6 Open Graph

In Enable for Product Page: Choose Yes to enable Open Graph when sharing Product Pages via Facebook, otherwise choose No.

In Enable for Category Page: Choose Yes to enable Open Graph when sharing Category Pages via Facebook, otherwise choose No.

In Enable for Website: Choose Yes to enable Open Graph when sharing your homepage via Facebook, otherwise choose No.

Open Graph

2.3.7 Twitter Card

In Enable for Product Page: Choose Yes to enable Twitter Card when sharing Product Pages via Twitter, otherwise choose No.

In Enable for Category Page: Choose Yes to enable Twitter Card when sharing Category Pages via Twitter, otherwise choose No.

Twitter Card

In Enable for Website: Choose Yes to enable Twitter Card when sharing your homepage via Twitter, otherwise choose No.

2.4 In Redirect 301 SEO

2.4.1 General

In Enable: Choose Yes to enable the feature or choose No to disable it.

General

2.4.2 Redirect 301 SEO

This setting only applies for product pages.

In Default Redirect to: Set the default page for the 301 page to be redirected to. These are options for the destination of redirecting: Parent Category, Homepage and Other CMS Pages.

In case of choosing Parent Category, when a product is deleted, the links of that product will be redirected to the nearest parent category of the product. In case the product got several categories at a same level, the category will be redirected is the last category at the Categories section on Catalog management of the product.

Here are examples of deleted product links:

http://yourdomain.com/catalog/product/view/id/1401/category/23

http://yourdomain.com/product.html

http://yourdomain.com/category/product.html

In Time Period (in days) to Keep Redirect on Website: choose the time period for redirecting to be applied.

Redirects 301 SEO

2.5 In Canonical Tag

2.5.1 General

Canonical Tag General

In Enable: Choose Yes to enable the feature or choose No to disable it.

2.5.2 Canonical Tag for Product

Canonical Tag for Product

In Canonical for Product: There are 2 available options:

Use Long Url Path: Set the Canonical Tag on the longest product URL. If the product belongs to multiple categories with the same category level, the applied category will be the last category at the Categories section on Catalog management of the product. Take the below image as an example, the applied category will be Jackets.

Category

2.5.3 Canonical Tag for Homepage

In Use Other Url for Homepage: Leave if blank if you want to use the default Canonical Tag for Homepage. Fill in URL path if you want the crawler to read that URL instead of the homepage.

2.5.4 Canonical Tag for Category

In Use Next/Previous Tag in Category: Choose Yes to enable canonical for Next/Previous Tag in categories or choose No to disable it.

2.6 In Advanced Breadcrumbs SEO

2.6.1 General

Advanced Breadcrumbs SEO General

In Enable: Choose Yes to enable the feature or choose No to disable it.

2.6.2 Breadcrumbs SEO

Breadcrumbs SEO

This setting will define the breadcrumbs for products and categories. Below is an example of

In Type of Breadcrumbs: There are 2 available options:

  • Use Long Url Path: Set the breadcrumbs to be the longest Path of product or category
  • Use ShortUrl Path: Set the breadcrumbs to be short path. For example, we have a path Men Category => Top Category => Jacket Category => Product A. Then the Breadcrumbs for Jacket will be Home => Jacket. You can take a look at the example below

Breadcrumb Frontend

The Breadcrumbs for Product A will be Home => Jacket => Product A. You can take a look at the example below. If the product belongs to multiple categories with the same category level, the applied category will be the last category at the Categories section on Catalog management of the product.

Advanced Breadcrumb

In Enable Category Priority: Choose Yes to enable category priority or No to disable it.

To manage category priority, please go to Store Marketing Advanced Breadcrumbs

Advanced Breadcrumbs

  • ID: show the ID of the category. In this section, all available categories of your site will be listed.
  • Path: show the path of the category.
  • Level: show the category level. Only categories which the category level is greater or equal 2 can be applied breadcrumbs
  • Priority: fill in the ID of the prior category. Take a category 5 with the path of 1/2/3/5 as an example. If you fill in the priority as 3, Breadcrumbs of category 5 and all of its belonging products will be displayed with category 3 as the priority.

2.7 In HREFLANG Tag Support

In Enable: Choose Yes to enable the feature or choose No to disable it.

In Add HREFLANG for Store View: Assign language and country for each store view.

HREFLANG Tag Support

In Enable for Homepage: Choose Yes to enable Hreflang tag for Homepage or choose No to disable it.

In Enable for Category: Choose Yes to enable Hreflang tag for Category Pages or choose No to disable it.

Enable

In Enable for CMS Page: Choose Yes to enable Hreflang tag for CMS Pages or choose No to disable it.

In Enable for Product Page: Choose Yes to enable Hreflang tag for Product Pages or choose No to disable it.

2.8 In Robots Meta Tag

Robots Meta Tag

In Enable: Choose Yes to enable the feature or choose No to disable it.

In Robots Meta Tag: Enter URL Pattern based on these following formats.

  • With specific Category Page or Product Page: enter the URL key. For example: your product page URL is http://yourdomain.com/teton-pullover-hoodie.html. Then URL key is teton-pullover-hoodie.
  • With categories or a folder: Enter the path with “/” before and after the path

For example: You want to set No Index and No Follow for all categories with the “tops-men” URL key. Please enter: /tops-men/

In Option: There are 3 options for you to choose, which is INDEX, NO FOLLOW NOINDEX, FOLLOW and NOINDEX, NOFOLLOW.

Meta Header

In NOINDEX, FOLLOW Robots Meta Header: Choose pages to set up No Index, Follow Tag.

2.9 In Meta Tags Template

2.9.1 Feature Settings

Feature General Setting

In Enable, choose Yes to enable the feature or choose No to disable it.

In Product Setting:

  • In Max Product Meta Title Length: Choose the maximum number of characters for product meta title (should be about 70-71 characters).
  • In Max Product Meta Description Length: Choose the maximum number of characters for product meta description (should be about 160 characters).
  • In Max Product Meta Keywords: Choose the maximum number of product meta keywords (should be about 30 words).

Product Setting

In Category Setting:

  • In Max Category Meta Title Length: Choose the maximum number of characters for category meta title (should be about 70-71 characters).
  • In Max Category Meta Description Length: Choose the maximum number of characters for category meta description (should be about 160 characters).
  • In Max Category Meta Keywords: Choose the maximum number of category meta keywords (should be about 30 words).

Category Setting

2.9.2 Product Meta Template

Please go to Marketing SEO & Search Product Meta Template and start configuration.

Choose Add New to create a new product meta template.

Product Meta Template

New Product Meta Template

In General:

  • In Enable: Choose Yestoenable the template or No to disable it.
  • In Name: Choose the name for the template.
  • In Scope: Choose the scope (store view, website) to apply the template. You can choose multiple store view/website by hold Ctrl and click.

Category

  • In Category: Choose the category to apply the template for all products belonging to it.
  • In Replace Current Meta Data: Choose Yes to replace all existing meta data of products with the new meta data in the template, otherwise choose No.
  • In Replace Current Description: Choose Yes to replace all existing description of products with the new description in the template, otherwise choose No.
  • In Apply for Sub-categories: Choose Yes to apply the template for products under sub-categories of the selected category, otherwise choose No.
  • In Priority, choosepriority for the template. In case the product is under multiple categories with different templates, the priority settings will be considered for the affected meta template to avoid conflict. The smaller number will be priority.

Template Setting

In Template Settings:

  • In Meta Title: Write the meta title for products. You can click on Insert Template Variables to choose the variables we provide.
  • In Meta Description: Write the meta description for products. You can click on Insert Template Variables to choose the variables we provide.
  • In Meta Keyword: Write the meta keywords for products. You can click on Insert Template Variables to choose the variables we provide.
  • In Short Description: Write the short description for the products. In the WYSIWYG editor, the Insert Template Variables will not be shown. Click on Show/Hide Editor to show the regular text area with variables.
  • In Description: Write the short description for the products. In the WYSIWYG editor, the Insert Template Variables will not be shown. Click on Show/Hide Editor to show the regular text area with variables.

Lastly, click Save Template to finish the settings.

Description

2.9.3 Category Meta Template

Please go to Marketing SEO & Search Product Meta Template and start configuration.

Choose Add New to create a new category meta template.

Category Meta Template

In General:

  • In Enable: Choose Yestoenable the template or No to disable it.
  • In Name: Choose the name for the template.
  • In Scope: Choose the scope (store view, website) to apply the template. You can choose multiple store view/website by hold Ctrl and click.
  • In Category: Choose the category to apply the template. You can choose multiple store view/website by hold Ctrl and click.

New Category Meta Template

  • In Replace Current Meta Data: Choose Yes to replace all existing meta data of categories with the new meta data in the template, otherwise choose No.
  • In Replace Current Description: Choose Yes to replace all existing description of categories with the new description in the template, otherwise choose No.
  • In Apply for Sub-categories: Choose Yes to apply the template for sub-categories, otherwise choose No.
  • In Priority choose priorityfor the template. In case the categories is under multiple categories with different templates, the priority settings will be considered for the affected meta template to avoid conflict. The smaller number will be priority.

Replace

In Template Settings:

  • In Meta Title: Write the meta title for categories. You can click on Insert Template Variables to choose the variables we provide.
  • In Meta Description: Write the meta description for categories. You can click on Insert Template Variables to choose the variables we provide.

Template Setting

  • In Meta Keyword: Write the meta keywords for categories. You can click on Insert Template Variables to choose the variables we provide.
  • In Description: Write the short description for the categories. In the WYSIWYG editor, the Insert Template Variables will not be shown. Click on Show/Hide Editor to show the regular text area with variables.

Lastly, click Save Template to finish the settings.

Meta Keyword

Was this article helpful to you? Yes No

How can we help?