The SEO Framework


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

This plugin provides an automated, accessible, unbranded and extremely fast SEO solution for any WordPress website.

For optional advanced SEO tools and output, check out our free companion plugin Extension Manager. Visit our recently published Extensions overview page for more information about our extensions.

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 vastly documented.
Don’t forget to set up the social meta settings and a home page description; those can greatly increase conversion.

This plugin:

  • Improves search presence by ranking your website distinctively.
  • Is preconfigured, providing a suitable starting point for most websites.
  • Listens to all WordPress gives to automatically configure SEO.
  • Allows you to adjust the SEO through global options.
  • Allows you to SEO every public page, post, taxonomy, and term.
  • Shows you how to improve SEO with a beautiful SEO bar.
  • Helps your pages get shared more beautiful through Facebook, Twitter, and other social sites.
  • Supports custom post types, like WooCommerce and bbPress.
  • Allows for easy SEO plugin switch using a tool.

Read this guide on 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 comments 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:

  • Titles according to your settings with archive prefixes.
  • Descriptions with anti-spam techniques and detection that informs you when it can be improved.
  • A canonical URL to prevent duplicated content; with full Domain Mapping, subdomain, and HTTPS support.
  • Various Open Graph, Facebook and Twitter tags.
  • Special Open Graph descriptions, which organically integrates within the Facebook and Twitter snippets.
  • Open Graph images, they are automatically resized and optimized when needed.
  • Structured Data for Google Search and Chromium that adds extended on-site search support.
  • Structured Data for Google’s Knowledge Graph; like Personal/Business site relations, names, and logos.
  • Structured Data for Breadcrumbs that extend pages and categories relationship support in Google Search.
  • Structured Data for Google Search that lets it know your preferred site name.
  • Publishing and editing dates for Social Sites and Search Engines alike.
  • Paginated content relationship links, to help visitors going to the right page.
  • A sitemap with all your pages, posts and CPT, which listens to their set settings.
  • Feed excerpts and backlinks within, to prevent automated content theft.

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 website updates 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 100 site settings, including:

  • Automated title output options; they encourage you to follow the guidelines.
  • Automated description output options.
  • Structured Data output options.
  • Various robots meta output options.
  • Many home page specific options.
  • Facebook, Twitter, and Pinterest social integration options.
  • Google, Bing, Pinterest and Yandex Webmaster verification codes.
  • Sitemap integration with personalization.
  • 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.


This plugin supports:

  • PHP 5.3 and higher.
  • WordPress 4.4 and higher.
  • Internationalization through
  • Multibyte calculation and rendering, including Emoji and CJK.
  • Right to Left (RTL) languages, through its interface and generation.
  • Extended colour vision deficiency accessibility.
  • Screen reader accessibility.
  • MultiSite, this plugin is in fact built upon one.
  • Detection of robots.txt and sitemap.xml files.
  • Both up-to-date and outdated themes.
  • Detection of various other popular SEO tools to prevent duplicated output.
  • Translation plugins WPML, Polylang and qTranslate X.
  • WooCommerce, for free, in all its glory.

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 and works great with various translation plugins.

However, if you 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 in 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 in the Sitemap of this plugin.


  • This plugin shows you what you can improve, at a glance. With complete colour vision deficiency support.
  • 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.
  • The dynamic Post/Page SEO settings meta box. Another version of this box is also implemented for Categories and Tags.
  • The dynamic Post/Page SEO settings meta box also fits neatly in the sidebar. For when you want to work faster.
  • The SEO Settings Page. With over 100 settings, you are in full control.


This plugin requires:

  • PHP 5.3 or later.
  • WordPress 4.4 or later.

Installation instructions:

  1. Install The SEO Framework either via the plugin directory or by uploading the files to your server.
  2. Either Network Activate this plugin or activate it on a single site.
  3. That’s it!

This plugin auto-configures its global settings, but:

  • Check out the SEO settings page to fine-tune your settings.
  • Do fill in the Schema “General” and “Presence” settings.
  • Do fill in the Home Page “General” settings.
  • Do fill in the Social Meta “General”, “Facebook” and “Twitter” settings.
  • Notice that red checkboxes are recommended to be left unchecked. And green checkboxes are recommended to be checked.

This plugin auto-configures SEO meta settings, and:

  • You can fine-tune each page with the provided meta box.

Get more SEO power


Installation Instructions

This plugin requires:

  • PHP 5.3 or later.
  • WordPress 4.4 or later.

Installation instructions:

  1. Install The SEO Framework either via the plugin directory or by uploading the files to your server.
  2. Either Network Activate this plugin or activate it on a single site.
  3. That’s it!

This plugin auto-configures its global settings, but:

  • Check out the SEO settings page to fine-tune your settings.
  • Do fill in the Schema “General” and “Presence” settings.
  • Do fill in the Home Page “General” settings.
  • Do fill in the Social Meta “General”, “Facebook” and “Twitter” settings.
  • Notice that red checkboxes are recommended to be left unchecked. And green checkboxes are recommended to be checked.

This plugin auto-configures SEO meta settings, and:

  • You can fine-tune each page with the provided meta box.

Get more SEO power

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?

The SEO Framework is its own self-serving technical framework. It keeps track of everything WordPress and SEO while it allows other plugins to interact with it easily.
Through its framework it allows you to SEO your complete website. It 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; however, The SEO Framework provides an easier and faster way of doing so.

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 modify how this plugin works

The SEO Framework is very pluggable in many fields. Please refer to the API documentation.

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 do the application/ld+json scripts 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 metadata 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.


Excellent SEO Management Plugin

This plugin has virtually zero bloat and is an Excellent alternative to the other very popular but extremely bloated SEO plugin on the market. I don’t normally leave reviews, but I had to, given how great this plugin performs with very little frustration, definitely recommended. Great Job!

So long Yoast hello the new SEO Framework

This is by far a revelation in SEO plugins, the developer has done a great job on creating a smooth, lightweight SEO plugin to rival the long standing champions. One thing missing for me a simple redirect addon would be great.

Apart from that this is our new go to WordPress SEO plugin, so much so we have featured a blog post on it A Design Day – SEO Review


Finally a non bloated SEO-plugin. This is exactly how it should be done. Feels way more integrated into WP with a native feel. Switched to this from YOAST SEO on all my sites and it’s working great! With the SEO data transporter plugin the switch was super easy.

Great lightweight plugin – just what is needed

This plugin came along just at the right time when other plugins were getting too bloated and starting to cause problems. I love that it just has what is necessary and seems top quality and is maintained and well supported by the author, plus there is no premium version – it is just great free plugin. That said there are one or 2 features (including more control over default meta title and description) that would be good but it seems like Sybre listens to people and new features are being added and improvements made. As long as things don’t change too much I can see this being rated the best SEO plugin by many including myself.

The new go-to SEO Plugin

Wow really this is the best, I was using “the other seo plugin” (you know the one) for a long time but after years of suffering from its performance impact and general heavyhanded cruft I finally switched to this one (on advice from the team) and WOW, I MEAN REALLY WOW. *This* Should be the #1 plugin in the world.

Read all 128 reviews

Contributors & Developers

“The SEO Framework” is open source software. The following people have contributed to this plugin.


“The SEO Framework” has been translated into 8 locales. Thank you to the translators for their contributions.

Translate “The SEO Framework” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


2.9.4 – Terminal Queries

Release date:

  • August 30th, 2017


  • New performance options have been added. They allow you to optimize Search and Archive query alterations.
  • JSON-LD data is now cleaner when you run PHP 5.4 or later.
  • Custom input image URLs can now dynamically switch between HTTP and HTTPS and the dimensions are always set, regardless of input.
  • Multisite networks no longer initiate new database connections on every page for plugin compatibility checks.

Did you know?

  • Local SEO has been added to the Extension Manager.
  • It increases location-aware search presence in Google Search, Google Maps, and even Google Images.

Detailed log:

2.9.3 – Assiduous Substratum

Release date:

  • July 3rd, 2017

Announcement: Local SEO Beta

  • Local SEO is a premium extension, and it’s almost ready for testing.
  • As we do not want to spam your WordPress dashboard, I’ve created a new Twitter account for future announcements.
  • Feel free to follow us to receive the latest updates. As we’re planning a test-run prior to release, further details for beta-access will also follow in a tweet.


  • Social images can now scale up to 4K resolution. This means (manual and automated) forced cropping no longer initiates at 1500px but at 4096px.
  • A new option has been added for every taxonomical post type in the Visibility tab. It allows you to prevent the annotated pages from showing up in Archives.
  • Structured Data output has been revisited. This includes merging of output, removal of misplaced output, and performance improvements.
  • When your home page is a blog, pages without an ID (404, search, date archives, etc.) had output and caching issues. These issues have been resolved.
  • Several security concerns have also been addressed. Although, none of them could be verified as the coding environment is already well protected.

For everyone: Caching changes:

  • Descriptions and output transients are no longer enabled by default. Because for most sites, it’s better left disabled.
  • This has been done to reduce database calls. Ultimately, the performance benefits of using the transients are use-case specific.

For developers: output code changes:

  • The output code has been rewritten. This improves reliability, performance and extensibility.
  • If you’ve extended or altered the generation output, you might wish to revisit your coding implementations.
  • All affronted methods have been correctly deprecated and tested once more. So, 500 errors shouldn’t occur.
  • To be certain, visit the detailed changelog and compare your code.

For high-traffic webmasters and Google Analytics integration plugin authors: About the Search URL change:

  • From this update, new canonical URLs will be generated for search queries to comply to the pretty permalink structure.
  • WordPress natively supports the /search/{search_term} endpoint; however, Google Analytics does not.
  • To enable support, please visit this page for more information.
  • I’ve created a plugin that will enhance support for you. You can download it here.
  • An extension is planned that will implement Google Analytics for you, complying to those guidelines.

Detailed log:

2.9.2 – Diminutive Consolidation

Release date:

  • May 8th, 2017


  • Now, Polylang is officially supported by The SEO Framework.
  • The sitemap now supports plain permalinks. That means it now literally works for every website.
  • The robots.txt file has been enhanced, so it now informs you when the output location is incorrect.
  • Moreover, various bugs have been fixed, mainly concerning third party plugins.

We’re looking for translation editors:

  • First, thank you so much to all the translation contributors.
  • Now, if you want to see The SEO Framework in your language, head over to this page and feel free to contribute.
  • If you wish to easily maintain and keep a close eye on all the contributions for your language, ask us to ask WordPress Polyglots to add you as a contributor.
  • Ultimately, it’s up to the WordPress Polyglots team to fulfil your request. It generally depends on how well you’ve submitted translations for you to be accepted.

A few notes about translations:

  • If you use a machine to translate for you, note that they can generate out-of-context strings. So keep an eye out for those!
  • If you notice that strings are very hard to translate, e.g. because of grammatical gender, let us know!
  • Please don’t translate “The SEO Framework”, it’s a registered brand-name.
  • Be sure not to add spaces if you see backticks, asterisks, or brackets. They’re used for Markdown language construction.
  • In TSF, you generally can’t use UTF character codes like ♡, as they’re automatically removed or rendered unreadable for added security. Add them as displayed instead: .

Detailed log:

  • If you are a friend, speak the password, and the doors will open, and you can enter.

2.9.1 – Sovereign Comprehension

Release date:

  • March 27th, 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:

2.9.0 – Equitable Erudition

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

Release date:

  • March 25th, 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 meta box.
  • 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.
  • Therefore, this layout 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 meta box.
  • 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 colours 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:

Full changelog

  • The full changelog can be found here.