The SEO Framework


Easy SEO for beginners, an awesome API for experts. WordPress SEO for everyone.

An accessible, unbranded and extremely fast SEO solution for any WordPress website.

For optional advanced SEO options and output, check out our free companion plugin Extension Manager.

This plugin strongly helps you create better SEO value for your content.
But at the end of the day, it all depends on how entertaining or well-constructed your content or product is.

No SEO plugin does the magic thing to be found instantly. But doing it right helps a lot.
The SEO Framework helps you doing it right. Give it a try!

The Default Settings are recommended within the SEO Settings page. If you know what you’re doing, go ahead and change them! Each option is also documented.

What this plugin does, in a few lines

  • Automatically configures SEO for every page, post, taxonomy and term.
  • Allows you to adjust the SEO globally.
  • Allows you to adjust the SEO for every applicable page, post, taxonomy and term.
  • Shows you how to improve your SEO with a beautiful SEO bar for each supported Post, Page and Taxonomy.
  • Helps your pages get ranked distinctively through various Metatag and scripting techniques.
  • Helps your pages get shared more beautiful through Facebook, Twitter and other social sites.
  • Allows plugin authors to easily extend this plugin.
  • Supports custom post types, like WooCommerce and bbPress.
  • Automatically upgrades itself from Genesis Framework SEO.
  • Allows for easy SEO plugin switch using a tool.

*Read this guide for transferring SEO Content using SEO Data Transporter.

Unbranded, Free and for the Professional

This plugin is unbranded! This means that we don’t even put the name “The SEO Framework” anywhere within the WordPress interface, aside from the plugin activation page.
This plugin makes great use of the default WordPress interface elements, like as if this plugin is part of WordPress. No ads, no nags.
The small and hidden HTML comment can easily be disabled with the use of a filter or extension.

Nobody has to know about the tools you’ve used to create your or someone else’s website. A clean interface, for everyone.

Completely automated

By default, this plugin automatically generates:

  • Title, with super-fast ‘wrong themes’ support.
  • Description, with anti-spam techniques.
  • A canonical URL, with full Domain Mapping, subdomain and HTTPS support to prevent duplicated content.
  • Various Open Graph, Facebook and Twitter tags.
  • Special Open Graph description, which organically integrates with the Facebook and Twitter snippets.
  • Extended Open Graph Images support, including automated image manipulation.
  • JSON-LD script that adds extended search support for Google Search and Chrome.
  • JSON-LD script for Knowledge Graph (Personal/Business site relations, name and logo).
  • Advanced JSON-LD script for Breadcrumbs (just like the visual one) which extends page relation support in Google Search.
  • JSON-LD script to show the correct site name in Google Breadcrumbs.
  • Publishing and editing dates, accurate to the day.
  • Link relationships, with full Domain Mapping and HTTPS support.
  • Simple Sitemap with Pages, Posts and Custom Post Types (CPT), which listens to the in-post settings.
  • Feed excerpts and backlinks to prevent content scraping.

This plugin goes further, behind the screens it:

  • Prevents canonical errors with categories, pages, subdomains and Multisite Domain Mapping.
  • Discourages 404 pages and empty categories from being indexed, even if they don’t send a 404 response.
  • Automatically notifies Google, Bing and Yandex on Post or Page update and deletion when sitemaps are enabled.

Generously personal

This plugin allows you to manually set various values for each post, page, public CPT and term.

This plugin allows you to adjust over 90 site settings, including:

  • Title and Description Separators and additions.
  • Automated description output.
  • output, including Knowledge Graph options.
  • Various robots’ options.
  • Many home page specific options.
  • Facebook, Twitter and Pinterest social integration
  • Shortlink tag output.
  • Link relationships
  • Google, Bing, Pinterest and Yandex Webmaster verification
  • Sitemap integration.
  • Robots.txt sitemap integration.
  • Feed anti-scraper options.
  • And many, many more settings.

Openly pluggable

The SEO Framework has been built to go further than just itself.
Take a look at the API documentation located at The SEO Framework API Docs.

The SEO Bar

This plugin helps you to create better content, at a glance. By showing you:

  • If the title is too long, too short, duplicated, and/or automatically generated.
  • If the description is too long, too short, duplicated, has too many repeated words and/or automatically generated.
  • If the page is indexed, redirected, followed and/or archived, while looking at other WordPress settings.

We call this The SEO Bar. Check out the Screenshots to see how it helps you!

Hardcore caching

This plugin’s code is highly optimized on PHP-level and uses variable, object and transient caching. This means that there’s little extra page load time from this plugin, even with more Meta tags used.
A caching plugin isn’t even needed for this plugin as you won’t notice a difference, however it’s supported wherever best suited.


  • PHP 5.3 and later
  • WordPress 4.4 and later
  • Full internationalization support through
  • Extended Multibyte support (CJK).
  • Full Right to Left (RTL) language support.
  • Extended Color vision deficiency accessibility.
  • Screen reader accessibility.
  • Full MultiSite support, this plugin is in fact built upon one.
  • Detection of robots.txt and sitemap.xml files.
  • Detection of theme Title output “doing it right” (or wrong).
  • Automatic detection of various other popular SEO tools.

If you have other popular SEO plugins activated, this plugin will automatically prevent SEO mistakes by deactivating itself on almost every part.

An additional sitemap

The Sitemap generated with The SEO Framework is sufficient for Search Engines to find Posts, Pages and supported Custom Post Types throughout your website.
It also listens to the noindex settings on each of the items.
If you however require a more expanded Sitemap, feel free to activate a dedicated Sitemap plugin. The SEO Framework will automatically deactivate its Sitemap functionality when another (known) Sitemap plugin is found.
If it is not automatically detected and no notification has been provided on the Sitemap Settings, feel free to open a support ticket and it will be addressed carefully.

Hidden breadcrumbs

The Breadcrumb script generated by this plugin on Posts will also make sure Google easily finds related categories which aren’t included within the Sitemap of this plugin.


Add any of the filters to your theme’s functions.php or a plugin to change this plugin’s output.

Learn about them here: The SEO Framework filters


Use any of these actions to add your own output.

They are found here: The SEO Framework actions

Settings API

Add settings to and interact with The SEO Framework.

Read how to here: The SEO Framework Settings API

Beta Version

Want to test the latest version before it’s released?

If there’s a beta, it will be available on GitHub. Please note that changes there might not reflect the final outcome of the full version release. Use at own risk.


  • (version 2.7+) This plugin shows you what you can improve, at a glance. With full color vision deficiency support.
  • (version 2.7+) Hover over any of the SEO Bar's items to see how you can improve the page's SEO. Red is bad, orange is okay, green is good. Blue is situational.
  • (version 2.9+) The dynamic Post/Page SEO settings Metabox. Another version of this box is also implemented for Categories and Tags.
  • (version 2.9+) The dynamic Post/Page SEO settings Metabox also fits neatly in the sidebar. For when you want to work faster.
  • (version 2.7+) The SEO Settings Page. With over 90 settings, you are in full control. Using the Default Settings and filling in the Knowledge Graph Settings and Social Meta Settings is recommended to do.


Is The SEO Framework Free?

Absolutely! It will stay free as well, without ads or nags!

Is there a Premium version?

Nope! This plugin is all-inclusive.

Free & Premium Extensions

For more advanced SEO options and output, we offer the free plugin Extension Manager.

I have a feature request, I’ve found a bug, a plugin is incompatible…

Please visit the support forums and kindly tell me about it. I try to get back to you within 48 hours. 🙂

Is this really a Framework?

This plugin is not in particular a framework in a technical sense, but it is built with a framework’s mindset. It is however a framework for your website’s SEO, a building block that keeps everything together.
This means that this plugin will do all the great Search Engine Optimization, and also allows for extensions and real-time alterations. For when you really want or need to change something.
Extensions built for this plugin might just as well work as a standalone. The SEO Framework provides an easier and cached way of doing so, however.

I am a developer; how can I help?

The SEO Framework is currently a one-man project. However, any input is greatly appreciated and everything will be considered.
Please visit the GitHub project page to submit issues or even pull requests.

I want to remove or change stuff, but I can’t find an option!

The SEO Framework is very pluggable on many fields. Please refer to the Other Notes.
Please note that a free plugin is underway which will allow you to change all scalar filters from the dashboard. No ETA yet.

The sitemap doesn’t contain categories, images, news, etc. is this OK?

This is not an issue. Search Engines love crawling WordPress because its structure is consistent and well known.
If a visitor can’t find a page, then why would a Search Engine? Don’t rely on your sitemap, but on your content and website’s usability.

What’s does the application/ld+json script do?

The JSON-LD scripts are Search Engine helpers which tell Search Engines how to connect and index the site.
They can tell the Search Engine if your site contains an internal search engine, what sites you’re socially connected to and what page structure you’re using.
This is also referred to as Structured Data.

The meta data is not being updated, and I’m using a caching plugin.

All The SEO Framework’s metadata is put into Object cache when a caching plugin is available. The descriptions and scripts are put into Transients. Please be sure to clear your cache.

I want to transport SEO data from other plugins to The SEO Framework, how do I do this?

Please refer to this small guide: SEO Data Migration.
Transporting Terms and Taxonomies SEO data isn’t supported.


Cybr, спасибо!


Отличный плагин SEO, верил в создателя с самого начала. С каждым обновлением всё лучше. Были вопросы, писал автору, Cybr ответил на все.

Read all 99 reviews


2.9.1 – Sovereign Comprehension

Release date:

  • 27th March 2017


  • This release patches a few bugs that were brought with the 2.9.0 release related to debugging and cache clearing.
  • And if you like to use quick edit a lot, the SEO Bar will now also re-render on save.

Detailed log:

All we have to decide is what to do with the time that is given us.

2.9.0 – Equitable Erudition

Courage is found in unlikely places – J.R.R. Tolkien

Release date:

  • 25th March 2017


  • This update focuses on fixing bugs and expanding the API for developers.
  • To expand the API for per page (in-post) SEO settings, tabs had to be added in the SEO settings metabox.
  • The JavaScript code has also been overhauled to improve performance and allow third party implementation.
  • Moreover, the home page settings now allow you to upload a social image.
  • Structured data markup has also been improved, like the inclusion of an alternative Sitename and fixes for Breadcrumb images.
  • The sitemap can now include the blog page. The lastmod value of which listens to multiple pages to automatically determines what’s best.
  • Unfortunately, Twitter has removed support for photo cards. This update makes sure that the regarding settings correctly convert to the current format.

Only one week left for the earliest of early-bird discounts:


  • After updating, please fill in our Update Survey: tell us what you like or can be done better.

For everyone: Tabbed In-post SEO layout

  • This release brings tabbed layout to the in-post SEO settings.
  • With this change I’ve also altered the overall looks, with the help from Daniel.
  • This layout allows extensions from the Extension Manager to be implemented much easier.
  • This layout is self-responsive! This means it’s not dependent on the browser-size, but on how much content will fit.
  • This layout therefore allows the SEO settings to be placed in the right sidebar! Take a look at the new screenshots.

For everyone: Browser support

  • This release brings CSS Flexbox to the new in-post SEO settings metabox.
  • The flexbox module is still experimental, in a way that not all browsers correctly support this to the fullest extend.
  • However, support for as many browsers feasible has been implemented. Check out the list. Enjoy!
  • The gist is that Chrome, Firefox, IE10 and Safari 6 or later are supported.

SEO Tip of the Update – Trust in layout

  • Is your website glitchy and has placeholder images, unmatched colors or weirdly contrasting borders all over the place?
  • Consider going for a more modern and clean layout. Strip out what isn’t necessary. A clean layout implies professionalism and increases visitors’ trust.
  • Even if you’re just starting out with your website, remove all that could be but really isn’t. Because if you leave in placeholders for the future, it implies amateurism.
  • People want their truth to be confirmed or their problems to be solved. If you can’t confirm or solve the layout of your website, then they won’t trust you to do so for their issues.
  • Simply put: It doesn’t have to be perfect, it just must be done.

Detailed log:

It is some miles, but it will shorten your journey tomorrow.

Full changelog

The full changelog can be found here.

Contributors & Developers

This is open source software. The following people have contributed to this plugin.


Browse the code