# mageplaza/magento-2-seo-extension

> Magento 2 SEO extension

`composer require mageplaza/magento-2-seo-extension`

Canonical URL: https://packagento.com/mageplaza/magento-2-seo-extension

## At a glance

- **Vendor**: mageplaza (https://packagento.com/mageplaza.md)
- **Latest version**: 4.4.8 — released 2026-06-02
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/mageplaza/magento-2-seo-extension and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require mageplaza/magento-2-seo-extension:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Magento 2 SEO extension

## README


**Mageplaza SEO All-in-One for Magento 2** is a bundle of outstanding features that are auto-active when you install it from Mageplaza without any code modifications. It is also friendly with your store if you need to insert meta keywords and meta descriptions for your product. It will do perfectly for your better SEO.

[![Latest Stable Version](https://poser.pugx.org/mageplaza/magento-2-seo-extension/v/stable)](https://packagist.org/packages/mageplaza/magento-2-seo-extension)
[![Total Downloads](https://poser.pugx.org/mageplaza/magento-2-seo-extension/downloads)](https://packagist.org/packages/mageplaza/magento-2-seo-extension)

**IMPORTANT NOTE: This version of [Magento 2 SEO extension](https://www.mageplaza.com/magento-2-seo-extension/) on Github is free as a contribution to the Magento community from Mageplaza. This package does not include the technical support. Should you need technical support for this version of the extension, you will have to buy a license from Mageplaza. [Click here to buy](https://www.mageplaza.com/magento-2-seo-extension/).**

### Highlight Features for Magento 2 SEO Standard Edition
- Prevent Duplicate Content issue
- XML, HTML Sitemap
- Structured Data (Rich Snipet: Adding Rating, Reviews, Price, Stock status ...)
- Google, Bing, Pinterest ... verification
- Add Canonical URLs



### 1. Mageplaza SEO extension Documentation

- [Installation guide](https://www.mageplaza.com/install-magento-2-extension/)
- [User Guide](https://docs.mageplaza.com/seo-m2/index.html)
- [Download from our Live site](https://www.mageplaza.com/magento-2-seo-extension/)
- [Get Free Support](https://github.com/mageplaza/magento-2-seo/issues)
- Get premium support from Mageplaza: [Purchase Support package](https://www.mageplaza.com/magento-2-extension-support-package/)
- [Contribute on Github](https://github.com/mageplaza/magento-2-seo)
- [Releases](https://github.com/mageplaza/magento-2-seo/releases)
- [License](https://www.mageplaza.com/LICENSE.txt)



### 2. How to install Magento 2 SEO extension

#### Install module via composer (recommend)

Run the following command in Magento 2 root folder:

With Marketing Automation (recommend):
```
composer require mageplaza/magento-2-seo-extension mageplaza/module-sitemap mageplaza/module-smtp
php bin/magento setup:upgrade
```

Without Marketing Automation:
```
composer require mageplaza/magento-2-seo-extension mageplaza/module-sitemap
php bin/magento setup:upgrade
```

#### Install Package from copy-paste package

Download the latest version at [Mageplaza.com](https://www.mageplaza.com/magento-2-seo-extension/)
then follow [installation guide](https://www.mageplaza.com/install-magento-2-extension/)

### 3. SEO FAQs

##### Q: I got error: `Mageplaza_Core has been already defined`
A: Read solution: https://github.com/mageplaza/module-core/issues/3

##### Q: My site is down
A: Please follow this guide: https://www.mageplaza.com/blog/magento-site-down.html


### 4. Contribute to this SEO module

Feel free to **Fork** and contrinute to this module and create a pull request so we will merge your changes to `master` branch.


### 5. Magento 2 SEO extension Introduction

Improve your SEO for Magento 2 site. Use **[Magento 2 SEO All in One](https://marketplace.magento.com/mageplaza-magento-2-seo-extension.html)** to automatically optimize your site for Search Engines.
**Mageplaza SEO extension** will automatically optimize and greatly improve the performance of your Magento-based store in Search Engines. Magento 2 is great SEO-ready out-of-the-box that is really good for SEO. However it still needs some craftiness to be improved in a few areas.

Mageplaza SEO module will support a list of new useful tools and settings that help you have own all the technical optimization with automatically optimizing and inserting the meta tags and link elements that Google or other Search Engines like so much:

#### Stop Duplicating Content SEO

By automatically preventing the duplicate content problem, **Mageplaza SEO extension** will avoid your site from being affected badly to the search ranking or caused the traffic loss, and as a result, boost the SEO performance significantly.

![magento 2 seo duplicate content](https://i.imgur.com/BX2YeiW.jpg)


#### Magento 2 Structured Data

**Mageplaza SEO All-in-One** will **add schema structured data to Magento 2 store** automatically without configuration to help Search engines display your web pages better and more attractive.

![Magento 2 structured data](https://i.imgur.com/Diw8ydK.png)

#### SEO Metadata template rules (SEO Pro edition)

For the marketers, it’s critical to understand and use the metadata that helps to drive the customer from the search engines. With **Magento 2 SEO Pro edition**, it’s completely a huge advantage that you can set mass and dynamic metadata information for products, categories, pages, layered navigation.

![Magento 2 seo meta data](https://i.imgur.com/NdobHxN.jpg)


#### Magento 2 Hreflang tag (SEO Ultimate edition)

You can easily to use the ‘Hreflang’ tags to tell the Search Engines which language you’re using in the specific page so when the visitors search in that language, your page will rank higher.

![Magento 2 Hreflang](https://i.imgur.com/PNu5Td4.jpg)

#### SEO checklist (SEO Ultimate edition)

The smart list for a perfect performance! The SEO checklists can tell you what you haven’t done yet, what you should do or even warn you to make sure your SEO process is going the right way.

![Magento 2 seo checklist](https://i.imgur.com/0StlqWM.jpg)


#### SEO HTML/XML Sitemaps (SEO Pro edition)

While the XML sitemap is specifically written for the search engines spiders, the HTML one is primarily for users. Hence, creating those 2 sitemaps will help your site to be easier to understand for both search engines and the users.

#### LINK ALTERNATE TAG

Easily to

_(README truncated for .md surface. Full README on https://packagento.com/mageplaza/magento-2-seo-extension.)_

## Changelog

Changelog: https://www.mageplaza.com/releases/seo/

## Recent Versions

| Version | Released |
|---|---|
| 4.4.8 | 2026-06-02 |
| 4.4.7 | 2026-04-14 |
| 4.4.6 | 2025-07-07 |
| 4.4.5 | 2025-05-23 |
| 4.4.4 | 2025-04-15 |
| 4.4.3 | 2024-11-20 |
| 4.4.2 | 2024-07-16 |
| 4.4.1 | 2024-06-28 |
| 4.4.0 | 2024-05-04 |
| 4.3.1 | 2024-03-18 |

Showing 10 of 53 versions. Full release history on https://packagento.com/mageplaza/magento-2-seo-extension.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| mageplaza/module-core | ^1.5.14 |

## Quality

Latest release (4.4.8) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 85 | 85 warnings (ruleset: Magento2) — 59 auto-fixable with phpcbf |
| PHPMD | Warning | 18 | 18 rule violations (UnusedFormalParameter:4, UndefinedVariable:4, IfStatementAssignment:2, ExcessiveClassLength:1, TooManyFields:1) |
| Cpd | Pass | 0 |  |
| Composer validate | Info | 1 | valid; 1 advisory note (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 58 | 58 | – | – |
| 2.4.8 | – | 58 | 58 | – |
| 2.4.9 | – | – | 56 | 56 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["mageplaza/magento-2-seo-extension"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

mageplaza is a Magento 2 vendor on Packagento. See https://packagento.com/mageplaza.md for their full catalogue.