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

Installation Guide

After finishing purchasing process, we will immediately send you an email containing the link to download this extension.

(Please turn off Merge-JS before installing the module. Only Turn on Merge-JS when finishing the installation).

1. Install the extension(s)

Step 1:

Unzip the file.

Step 2:

Create another directory called app/code/Bss/MODULENAME/ where MODULENAME must be replaced by the modules internal identifier.

You can find it in the "composer.json" file in the extension ZIP file you downloaded, look at the node "psr-4". For example, it could say "Bss\\AjaxCart\\" or "Bss\\OneStepCheckout\\" there, then the MODULENAME is the part after \\ and before \\, so in our examples AjaxCart" or "OneStepCheckout". This is what you call the directory, then, for example app/code/Bss/AjaxCart, and you put the contents of the extension ZIP file in there.

Step 3:

Upload the directory app/code/Bss/MODULENAME/ into the root directory of your Magento installation. The root directory of Magento is the directory that contains the directories "app", "bin", "lib" and more. All directories should match the existing directory structure.

Step 4:

Go to Magento 2 root directory.

Run: php bin/magento setup:upgrade.


Run: php bin/magento setup:static-content:deploy.

Step 6:

Clear all Caches.

2. Install/Uninstall/Disable the Hyva Theme Compatibility package

2.1. To install the Hyva compatibility package:

First and foremost, install the SEO Suite package via composer following instruction here. The module names can be found in Appendix section below.

After finishing installing the SEO suite, run the following commands to install the Hyva theme compatibility packages via composer of 4 child modules that required Hyva compat version: BSS Breadcrumbs, BSS SEO Toolbar, BSS Rich Snippets and BSS HTML Sitemap. Other modules are automatically compatible with Hyva theme.

- composer require hyva-themes/magento2-bsscommerce-breadcrumbs

- composer require hyva-themes/magento2-bsscommerce-html-site-map

- composer require hyva-themes/magento2-bsscommerce-rich-snippets

- composer require hyva-themes/magento2-bsscommerce-seo-toolbar

*Note: The other child modules of SEO Extensions are already compatible with Hyva theme, so you would not need to install hyva-compat versions of these modules.

2.2. To disable the Hyva compatibility package, run the following commands:
- php bin/magento module:disable Hyva_BssBreadcrumbs

- php bin/magento module:disable Hyva_BssHtmlSiteMap

- php bin/magento module:disable Hyva_BssRichSnippets

- php bin/magento module:disable Hyva_BssSeoToolbar

2.3. To uninstall the Hyva compatibility package, run the following commands:
- composer remove hyva-themes/magento2-bsscommerce-breadcrumbs

- composer remove  hyva-themes/magento2-bsscommerce-html-site-map

- composer remove  hyva-themes/magento2-bsscommerce-rich-snippets

- composer remove  hyva-themes/magento2-bsscommerce-seo-toolbar

IMPORTANT: For BSS HTML Sitemap package, you would also need to install the Hyva Compat Base module.


Module names of SEO Suite:

BSS Breadcrumbs
bsscommerce/seo-suite (*)
BSS Canonical Tag
BSS HrefLang
BSS Redirects 301 Seo
BSS Robots Meta Tag
BSS Seo Alt Text
BSS Seo External Links
BSS Seo Report
BSS Seo Toolbar
BSS HTML Sitemap bsscommerce/html-sitemap
BSS Google XML Sitemap bsscommerce/google-xml-sitemap
BSS Meta Tag Manager bsscommerce/meta-tag-manager
BSS RichSnippets bsscommerce/rich-snippets
BSS Seo Core bsscommerce/seo-core

(*) This command will help install all the module on the left column of corresponding rows.


After purchasing this module, just add our skype account at support.bsscommerce, BSS Support Team will help you to install this extension immediately. Further assistance is available via Email and Skype.

In case you have followed all above steps but the extension still doesn’t work properly, you can delete the file or change the module’s filename to keep your website function as normal. Then please contact us via sales@bsscommerce.com or Skype: support.bsscommerce, our supporters will assist you in resolving any issues within 24 hours.

Was this article helpful to you? Yes 1 No

How can we help?