SEO EXTENSION FOR MAGENTO 2

1 User Guide SEO Extension for Magento 2 SEO EXTENSION FOR MAGENTO 2 USER GUIDE BSS COMMERCE 1

2 User Guide SEO Extension for Magento 2 Contents 1. SEO Extension for Magento 2 Overview... 4 2. How Does SEO Extension for Magento 2 Work?... 4 2.1. In Google XML Sitemap... 4 2.1.1. Homepage Options... 4 2.1.2. Categories Options... 5 2.1.3. Product Options... 6 2.1.4. CMS Page Options... 7 2.1.5. General Setting... 8 2.1.6. Sitemap File Limit... 9 2.1.7. Search Engine Submission Settings... 9 2.1.8. Additional Link List... 10 2.1.9. Generate Sitemap... 10 2.1.10. Edit and Delete Sitemap... 12 2.2. In HTML Sitemap... 13 2.2.1. General... 13 2.2.2. Search Engine Optimization... 14 2.2.3. Product List... 14 2.2.4. Store List... 15 2.2.5. Category List... 15 2.2.6. Additional Link List... 16 2.2.7. CMS Link List... 16 2.3. In Rich Snippets... 17 2.3.1. General Options... 17 2.3.2. Site Structure... 17 2.3.3. Local Business... 18 2.3.4. Product Options... 20 2.3.5. Category Options... 21 2.3.6. Open Graph... 22 2.3.7. Twitter Card... 23 BSS COMMERCE 2

3 User Guide SEO Extension for Magento 2 2.4. In Redirect 301 SEO... 23 2.4.1. General... 23 2.4.2. Redirect 301 SEO... 23 2.5. In Canonical Tag... 24 2.5.1. General... 24 2.5.2. Canonical Tag for Product... 25 2.5.3. Canonical Tag for Homepage... 25 2.5.4. Canonical Tag for Category... 26 2.6. In Advanced Breadcrumbs SEO... 26 2.6.1. General... 26 2.6.2. Breadcrumbs SEO... 26 2.7. In HREFLANG Tag Support... 28 2.8. In Robots Meta Tag... 30 2.9. In Meta Tags Template... 31 2.9.1. Feature Settings... 31 2.9.2. Product Meta Template... 32 2.9.3. Category Meta Template... 35 3. Contact Us... 39 BSS COMMERCE 3

4 User Guide SEO Extension for Magento 2 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 BSS COMMERCE 4

5 User Guide SEO Extension for Magento 2 In Show Homepage: Choose Yes to show homepage in 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 homepage in XML sitemap file, otherwise choose No to hide it. 2.1.2. 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 BSS COMMERCE 5

6 User Guide SEO Extension for Magento 2 will be hidden as well. 2.1.3. 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 Catalog Search 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 BSS COMMERCE 6

7 User Guide SEO Extension for Magento 2 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 into sitemap. Base Only: Only add base image of products into sitemap. All: Add all images of products into 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 In Frequency: Choose the frequency for the search engine crawlers to index CMS pages. The options are: Always - Hourly - Daily - Weekly - Monthly - Yearly - BSS COMMERCE 7

8 User Guide SEO Extension for Magento 2 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 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 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. BSS COMMERCE 8

9 User Guide SEO Extension for Magento 2 2.1.6. Sitemap File Limit 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 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. BSS COMMERCE 9

10 User Guide SEO Extension for Magento 2 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. 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 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. BSS COMMERCE 10

11 User Guide SEO Extension for Magento 2 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. BSS COMMERCE 11

12 User Guide SEO Extension for Magento 2 After saving the sitemap, click Generate for the sitemap to be created following the module settings. 2.1.10. Edit and Delete Sitemap Please go to Marketing Google XML Sitemap, select the sitemap you want to edit or delete. BSS COMMERCE 12

13 User Guide SEO Extension for Magento 2 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 Delete to delete the sitemap. To reset the sitemap, click Reset and then click Save. Back to the main section an 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 BSS COMMERCE 13

14 User Guide SEO Extension for Magento 2 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. 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 BSS COMMERCE 14

15 User Guide SEO Extension for Magento 2 of product links to be shown. The limit number you can fill in is 50000. 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. 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 ID of categories you want to hide in sitemap (separated by a coma). For example: 1,2,5,9,23,45,77. BSS COMMERCE 15

16 User Guide SEO Extension for Magento 2 2.2.6. 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 sitemap. Hold BSS COMMERCE 16

17 User Guide SEO Extension for Magento 2 Ctrl when choosing multiple options. 2.3. In Rich Snippets 2.3.1. General Options 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 search result, otherwise choose No. If you choose No, the Show Search Box in Search Result will be disabled. BSS COMMERCE 17

18 User Guide SEO Extension for Magento 2 In Website Name: Choose the name for your website to be displayed in search result. In Website Description: Write a description for your website to be displayed in 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 search result, otherwise choose No. 2.3.3. Local Business BSS COMMERCE 18

19 User Guide SEO Extension for Magento 2 In Enable Local Business: Choose Yes to show the following information of your website in search result, otherwise choose No. In Name of Business: Choose the name for your business to be displayed in 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. BSS COMMERCE 19

20 User Guide SEO Extension for Magento 2 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 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 search result, otherwise choose No. In Show Image: Choose Yes to show the product image in search result, otherwise choose No. BSS COMMERCE 20

21 User Guide SEO Extension for Magento 2 In Show Description: Choose Yes to show the product description in search result, otherwise choose No. In Show Review: Choose Yes to show the product review in search result, otherwise choose No. In Show Avg. Rating: Choose Yes to show the product average rating in search result, otherwise choose No. In Show Price: Choose Yes to show the product price in search result, otherwise choose No. In Show Availability: Choose Yes to show the product availability (in stock/out of stock) in search result, otherwise choose No. 2.3.5. Category Options In Show Name: Choose Yes to show the category name in 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 search result, BSS COMMERCE 21

22 User Guide SEO Extension for Magento 2 otherwise choose No. In Show Image: Choose Yes to show the category image in search result, otherwise choose No. 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. BSS COMMERCE 22

23 User Guide SEO Extension for Magento 2 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. 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. 2.4.2. Redirect 301 SEO This setting only applies for product pages. BSS COMMERCE 23

24 User Guide SEO Extension for Magento 2 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. 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. 2.5. In Canonical Tag 2.5.1. General In Enable: Choose Yes to enable the feature or choose No to disable it. BSS COMMERCE 24

25 User Guide SEO Extension for Magento 2 2.5.2. Canonical Tag for Product In Canonical for Product: There are 2 available options: Use Short Url Path: Set the Canonical Tag on the shortest product URL. Here is an example: http://yourdomain.com/product.html 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. 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 homepage. BSS COMMERCE 25

26 User Guide SEO Extension for Magento 2 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 In Enable: Choose Yes to enable the feature or choose No to disable it. 2.6.2. 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 Short Url Path: Set the breadcrumbs to be short path. For example we have a path Men Category => Top Category => Jacket Category => Product A. BSS COMMERCE 26

27 User Guide SEO Extension for Magento 2 Then the Breadcrumbs for Jacket will be Home => Jacket. You can take a look at the example below 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. BSS COMMERCE 27

28 User Guide SEO Extension for Magento 2 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 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 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. BSS COMMERCE 28

29 User Guide SEO Extension for Magento 2 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. 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. BSS COMMERCE 29

30 User Guide SEO Extension for Magento 2 2.8. In 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. BSS COMMERCE 30

31 User Guide SEO Extension for Magento 2 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 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). BSS COMMERCE 31

32 User Guide SEO Extension for Magento 2 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). 2.9.2. Product Meta Template Please go to Marketing SEO & Search Product Meta Template and start configuration. Choose Add New to create new product meta template. BSS COMMERCE 32

33 User Guide SEO Extension for Magento 2 In General: In Enable: Choose Yes to enable 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 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 BSS COMMERCE 33

34 User Guide SEO Extension for Magento 2 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, choose priority 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. 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 BSS COMMERCE 34

35 User Guide SEO Extension for Magento 2 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. 2.9.3. Category Meta Template Please go to Marketing SEO & Search Product Meta Template and start configuration. Choose Add New to create new category meta template. BSS COMMERCE 35

36 User Guide SEO Extension for Magento 2 In General: In Enable: Choose Yes to enable 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. BSS COMMERCE 36

37 User Guide SEO Extension for Magento 2 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 subcategories, otherwise choose No. In Priority choose priority for 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. 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. BSS COMMERCE 37

38 User Guide SEO Extension for Magento 2 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. BSS COMMERCE 38

39 User Guide SEO Extension for Magento 2 3. Contact Us Any questions or concern about us, feel free to contact: Website: http:/bsscommerce.com Support: support@bsscommerce.com Skype: support.bsscommerce BSS Support team is always ready to aid you with any issue referring to our products. Additionally, we also give you Website development and Administration Support. We do offer: 1. Free installation services for commercial products. 2. Free updates within offered support period. Our duties: 1. Responsibility for resolving product bugs. 2. Help with technical queries. 3. Technical support in installation and product usage. BSS COMMERCE 39