PHPackages                             yoast/yoast-seo-for-neos - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. yoast/yoast-seo-for-neos

ActiveNeos-plugin[Utility & Helpers](/categories/utility)

yoast/yoast-seo-for-neos
========================

Yoast SEO for Neos CMS

2.0.0(1y ago)24164.8k↓24.1%19[11 issues](https://github.com/Yoast/Yoast-SEO-for-Neos/issues)GPL-3.0-or-laterJavaScriptPHP ^8.2CI passing

Since Jun 18Pushed 1y ago15 watchersCompare

[ Source](https://github.com/Yoast/Yoast-SEO-for-Neos)[ Packagist](https://packagist.org/packages/yoast/yoast-seo-for-neos)[ Docs](https://yoast.com)[ RSS](/packages/yoast-yoast-seo-for-neos/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (3)Versions (29)Used By (0)

Yoast SEO integration for Neos CMS
==================================

[](#yoast-seo-integration-for-neos-cms)

[![Latest Stable Version](https://camo.githubusercontent.com/feceefff8838767d5da67c135dedd791caa118c3ff041c89e41d66b7d5dd64ea/68747470733a2f2f706f7365722e707567782e6f72672f796f6173742f796f6173742d73656f2d666f722d6e656f732f762f737461626c65)](https://packagist.org/packages/yoast/yoast-seo-for-neos)[![Total Downloads](https://camo.githubusercontent.com/07e197956806db2bf1e28c3ce9d73f1e650e3f6e92595950fdae683717d82a76/68747470733a2f2f706f7365722e707567782e6f72672f796f6173742f796f6173742d73656f2d666f722d6e656f732f646f776e6c6f616473)](https://packagist.org/packages/yoast/yoast-seo-for-neos)[![License](https://camo.githubusercontent.com/09d51e1f30a44fd1230c53f313c45c8bdb8cc4a9d90a3a26e09ae9e65fb0acef/68747470733a2f2f706f7365722e707567782e6f72672f796f6173742f796f6173742d73656f2d666f722d6e656f732f6c6963656e7365)](https://packagist.org/packages/yoast/yoast-seo-for-neos)[![Build Status](https://camo.githubusercontent.com/39e88c7ab7efa32799e7d12b917ee6c838514120f0c52476d1664ff67f1b1bf5/68747470733a2f2f7472617669732d63692e636f6d2f596f6173742f596f6173742d53454f2d666f722d4e656f732e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/Yoast/Yoast-SEO-for-Neos)

What does it do
---------------

[](#what-does-it-do)

This package provides a new backend preview and inspector integration for [Neos CMS](https://neos.io) to look at your page with the help of the [Yoast SEO](https://github.com/Yoast/YoastSEO.js) plugin.

This view will show you a preview snippet how the selected page will look in the Google search results and will give you insights and helpers to further improve the page for search engines.

These insights are generated via the official Open Source **Yoast SEO** javascript plugin by [Yoast](https://yoast.com). This package is being developed in partnership with *Yoast BV* and has been moved into the Yoast namespace since version 1.0.

We try to keep this package up-to-date with releases by Yoast but depending on the compatibility and available time this might take up to a few weeks after Yoast releases a new version of their library.

Examples
--------

[](#examples)

[![Preview in the Neos demo site](Documentation/snippet-preview.jpg)](Documentation/snippet-preview.jpg)

[![Inspector view in a blog](Documentation/inspector.jpg)](Documentation/inspector.jpg)

Installation
------------

[](#installation)

Add the dependency to your site package like this

```
composer require --no-update yoast/yoast-seo-for-neos
```

And then run `composer update` in your projects root folder.

### Deploying to production

[](#deploying-to-production)

As the package adds some additional permissions to the system you should flush the session cache once after the first deployment of your website which includes this package. This prevents errors for your logged in editors:

```
./flow flow:session:destroyAll
```

This will force them to login again, so be careful and warn them before doing this.

Dependencies
------------

[](#dependencies)

This package currently only requires Neos >= 3.0 but it's suggested to also have the `neos/seo` package installed. This package expects some document node properties to be present like `titleOverride` and `metaDescription` which are provided via the `neos/seo` package. But you can of course provide them yourself if you don't want to use the `neos/seo` package.

Supported languages
-------------------

[](#supported-languages)

There are three different kinds of language support:

### Backend localization for the Neos implementation

[](#backend-localization-for-the-neos-implementation)

These are localizations for all Neos CMS specifics not related to the wordpress version of YoastSEO.

- English ✅
- German ✅

If you can provide the backend localizations for other languages than the ones provided in the table above, please create a PR.

### Supported languages of the analyzer results in the backend

[](#supported-languages-of-the-analyzer-results-in-the-backend)

These are localizations for the recommendations that the analysis provides and will be selected based on the current users backend language.

Please consult [YoastSEO on wordpress](https://translate.wordpress.org/projects/wp-plugins/wordpress-seo).

### Supported content languages for the analyzer

[](#supported-content-languages-for-the-analyzer)

These are the content languages that the analyzer supports. If the language of your content is not contained in the list the analysis will still work but not give the same quality of recommendations.

Please consult [YoastSEO.js readme](https://github.com/Yoast/YoastSEO.js/blob/develop/README.md).

Configuration
-------------

[](#configuration)

In your `Settings.yaml` you can override the following options:

```
Yoast:
 YoastSeoForNeos:
   defaultContentLocale: en-US
   languageToLocaleMapping: [...]
```

and

```
Neos:
  Neos:
    Ui:
      frontendConfiguration:
        Yoast.YoastSeoForNeos:
          contentSelector: body
```

### defaultContentLocale

[](#defaultcontentlocale)

The analyzer will use the `lang` attribute rendered by the `Neos.Seo` package of your website to detect the language of your content. This option sets the default if `Neos.Seo` cannot detect it. If no `lang` attribute is rendered the javascript part will use `en_US`.

Note that the html standard requires a `-` in the locale while Neos and Yoast internally use `_` and convert if needed.

Check  for supported languages and the capabilities. If you use a locale that Yoast doesn't understand don't expect perfect results.

### languageToLocaleMapping

[](#languagetolocalemapping)

This array defines which translation should be used in the Yoast SEO analyzer depending on the selected interface language of a Neos user.

See the `Settings.yaml` of this package and if you for example want a different version localized translation, check out the folder `Resources/Private/Languages` and see which ones are supported and then update the mapping accordingly.

For example the default mapping for `de` is `de_DE` but can be changed to Swiss German with the following configuration:

```
Yoast:
  YoastSeoForNeos:
    languageToLocaleMapping:
      de: de_CH
```

### contentSelector

[](#contentselector)

This setting allows you to specify a different element in your rendered page where the analysis should retrieve it's content from. This can be used for example to select your content wrap to exclude hidden content for modals and other elements.

Example:

```
Neos:
  Neos:
    Ui:
      frontendConfiguration:
        Yoast.YoastSeoForNeos:
          contentSelector: .my-content
```

Usage
-----

[](#usage)

### Preview mode

[](#preview-mode)

After installation the new preview mode is available in the Neos backend which you can select form the `Edit / Preview` panel.

This is useful to check several pages after another and optimize SEO properties. The preview also shows a preview how a page could look as Google search result.

### Inspector

[](#inspector)

In the inspector a new group "Yoast" is added in the SEO-Tab with the following fields:

- focusKeyword: The main keyword this document is optimized for. This is needed by yoast for calculating metrics.
- isCornerstone: Mark the document as exceptionally important for yoast. This will enforce more strict content-rules.

The group also contains a live analyzer which will check your content and SEO data and show you the results. Depending on your nodetype configuration the analyzer will update after you change something and show you up-to-date information without needing a reload of the whole page.

This view is helpful when optimizing a single page while working on it's content.

FAQ
---

[](#faq)

### I get a login modal after opening the Yoast tab in the inspector

[](#i-get-a-login-modal-after-opening-the-yoast-tab-in-the-inspector)

First try to log out and log in again as the session might be missing some policy information.

If that doesn't help then the policy file of this package might not have been loaded. Clear your caches and make sure they appear when running `flow security:showeffectivepolicy --privilegeType "Neos\Flow\Security\Authorization\Privilege\Method\MethodPrivilege"`. Then logout and login again and everything should work again.

Contributing && issues
------------------------------

[](#contributing--issues)

- Contributions are very welcome.
- Pull requests are even better!
- Please open issues for [this project](https://github.com/Yoast/Yoast-SEO-for-Neos/issues) if you have problems with the backend module or other Neos specific features.
- Please open issues for [Yoast SEO](https://github.com/Yoast/javascript/tree/master/packages/yoastseo) if you have problems with the analyzer itself or translations of any hints and warnings generated by the analyzer.

### Building the assets

[](#building-the-assets)

First install dependencies with `yarn`:

```
yarn
```

You can generate the `js` and `css` files by running the following command:

```
yarn build
```

#### Building and watching the app for the edit mode

[](#building-and-watching-the-app-for-the-edit-mode)

```
yarn build:editMode
```

```
yarn watch:editMode
```

#### Building and watching the inspector view

[](#building-and-watching-the-inspector-view)

```
yarn build:inspectorView
```

```
yarn watch:inspectorView
```

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity45

Moderate usage in the ecosystem

Community26

Small or concentrated contributor base

Maturity86

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 93.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~99 days

Recently: every ~223 days

Total

26

Last Release

410d ago

Major Versions

0.2.2 → 1.0.0-beta2019-04-29

1.4.1 → 2.0.02025-04-04

PHP version history (4 changes)0.0.1PHP ~7.0

1.2.0PHP >=7.0

1.3.0PHP >=7.4

2.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/6629c5cbca8a0a1133c6a3a9df23fe802036694d8d79b10b7606a4355e5cb6df?d=identicon)[YoastSystem](/maintainers/YoastSystem)

![](https://www.gravatar.com/avatar/5c9f106db319e8698dcb4aedfe8034f0442d379ebbd78fcd67b884999b2236f1?d=identicon)[Sebobo](/maintainers/Sebobo)

---

Top Contributors

[![Sebobo](https://avatars.githubusercontent.com/u/596967?v=4)](https://github.com/Sebobo "Sebobo (284 commits)")[![mficzel](https://avatars.githubusercontent.com/u/1309380?v=4)](https://github.com/mficzel "mficzel (6 commits)")[![kdambekalns](https://avatars.githubusercontent.com/u/95873?v=4)](https://github.com/kdambekalns "kdambekalns (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![markusguenther](https://avatars.githubusercontent.com/u/1014126?v=4)](https://github.com/markusguenther "markusguenther (2 commits)")[![grebaldi](https://avatars.githubusercontent.com/u/2522299?v=4)](https://github.com/grebaldi "grebaldi (1 commits)")[![klfman](https://avatars.githubusercontent.com/u/9661367?v=4)](https://github.com/klfman "klfman (1 commits)")[![andrehoffmann30](https://avatars.githubusercontent.com/u/23524251?v=4)](https://github.com/andrehoffmann30 "andrehoffmann30 (1 commits)")[![skurfuerst](https://avatars.githubusercontent.com/u/190777?v=4)](https://github.com/skurfuerst "skurfuerst (1 commits)")[![bwaidelich](https://avatars.githubusercontent.com/u/307571?v=4)](https://github.com/bwaidelich "bwaidelich (1 commits)")[![daniellienert](https://avatars.githubusercontent.com/u/642226?v=4)](https://github.com/daniellienert "daniellienert (1 commits)")[![Discostu36](https://avatars.githubusercontent.com/u/30999326?v=4)](https://github.com/Discostu36 "Discostu36 (1 commits)")[![florianklueckmann](https://avatars.githubusercontent.com/u/9579134?v=4)](https://github.com/florianklueckmann "florianklueckmann (1 commits)")

---

Tags

hacktoberfestneos-cmsseoyoast-seoseoyoastNeos CMS

### Embed Badge

![Health badge](/badges/yoast-yoast-seo-for-neos/health.svg)

```
[![Health](https://phpackages.com/badges/yoast-yoast-seo-for-neos/health.svg)](https://phpackages.com/packages/yoast-yoast-seo-for-neos)
```

###  Alternatives

[artesaos/seotools

SEO Tools for Laravel and Lumen

3.3k5.1M60](/packages/artesaos-seotools)[jbroadway/urlify

A fast PHP slug generator and transliteration library that converts non-ascii characters for use in URLs.

6737.4M62](/packages/jbroadway-urlify)[yoast-seo-for-typo3/yoast_seo

Yoast SEO for TYPO3

521.6M9](/packages/yoast-seo-for-typo3-yoast-seo)[spatie/laravel-robots-middleware

Add an `all` or `none` robots header to your requests via a middleware in Laravel

3352.1M5](/packages/spatie-laravel-robots-middleware)[shel/neos-colorpicker

A plugin for Neos CMS which provides a colorpicker editor

1494.4k6](/packages/shel-neos-colorpicker)[neos/neos-base-distribution

Neos Base Distribution

4464.9k](/packages/neos-neos-base-distribution)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)