wordpress-seo
Last commit date
admin
3 months ago
blocks
4 months ago
css
3 months ago
images
3 months ago
inc
3 months ago
js
3 months ago
lib
3 months ago
packages
4 months ago
src
3 months ago
vendor
3 months ago
vendor_prefixed
6 months ago
index.php
10 years ago
license.txt
8 years ago
readme.txt
3 months ago
wp-seo-main.php
3 months ago
wp-seo.php
3 months ago
wpml-config.xml
3 years ago
readme.txt
359 lines
| 1 | === Yoast SEO - Advanced SEO with real-time guidance and built-in AI === |
| 2 | Contributors: yoast, joostdevalk, tdevalk |
| 3 | Donate link: https://yoa.st/1up |
| 4 | License: GPLv3 |
| 5 | License URI: http://www.gnu.org/licenses/gpl.html |
| 6 | Tags: SEO, XML sitemap, Content analysis, Readability, Schema |
| 7 | Tested up to: 6.9 |
| 8 | Stable tag: 27.1.1 |
| 9 | Requires PHP: 7.4 |
| 10 | |
| 11 | Improve your SEO with real-time feedback, schema, and clear guidance. Upgrade for AI tools, Google Docs integration, and 24/7 support, no hidden fees. |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | ## Yoast SEO: The #1 WordPress SEO Plugin |
| 16 | |
| 17 | Since 2008, **Yoast SEO** has helped millions of websites worldwide improve their visibility and SEO performance. |
| 18 | Our mission is **SEO for Everyone** — from small local businesses to some of the most visited sites on the web. |
| 19 | |
| 20 | Yoast SEO gives you everything you need to manage your on-site SEO effectively. |
| 21 | The [Yoast SEO Premium](https://yoa.st/1v8) plugin and its extensions unlock even more advanced and AI-powered tools. |
| 22 | |
| 23 | --- |
| 24 | |
| 25 | ### Handing you the competitive edge |
| 26 | |
| 27 | SEO is the most consistent and cost-effective source of website traffic — but it can be complex. Whether you're just starting out or an advanced user, Yoast SEO helps you handle SEO confidently and efficiently. |
| 28 | |
| 29 | Don't have time to stay on top of AI search and best practices? Keeping Yoast SEO updated means you automatically benefit from ongoing technical improvements, schema updates, and AI advancements — all guided by our signature traffic light approach. |
| 30 | |
| 31 | Empower search engines to better understand your website using **Schema.org structured data integration**, and access in-depth content and readability analysis tools that help you create content designed to perform well in search. |
| 32 | |
| 33 | --- |
| 34 | |
| 35 | ### Quick and easy setup |
| 36 | |
| 37 | Setting up Yoast SEO is quick and straightforward — no technical background required. |
| 38 | Our step-by-step configuration wizard walks you through essential setup details so Yoast SEO can generate accurate **structured data** that helps search engines understand your site. |
| 39 | |
| 40 | Switching from another SEO plugin like Rank Math or AIOSEO? Migration is seamless. |
| 41 | Import your existing SEO data and settings safely with our built-in import/export tools. |
| 42 | |
| 43 | --- |
| 44 | |
| 45 | ### Content and AI features |
| 46 | |
| 47 | Unlock your content's full potential with Yoast SEO's **advanced content analysis** and **AI-powered tools**. |
| 48 | |
| 49 | **Content optimization features:** |
| 50 | - Detailed **SEO analysis** to guide keyword targeting and site performance. |
| 51 | - **Readability analysis** for clear, engaging, and user-friendly writing. |
| 52 | - **SERP previews** for both desktop and mobile results. |
| 53 | - **HowTo and FAQ blocks** with built-in schema support. |
| 54 | - **Breadcrumbs block** for improved navigation. |
| 55 | - **Inclusive Language Analysis** to make your content more considerate and accessible. |
| 56 | - **Semrush integration** for keyword research directly in Yoast SEO. |
| 57 | - **Wincher integration** to track keyword performance inside your dashboard. |
| 58 | - **Elementor integration** for seamless optimization within your favorite builder. |
| 59 | |
| 60 | **AI features (included in Premium):** |
| 61 | - **[Yoast AI Generate](https://yoa.st/51c)** – Instantly create five SEO-friendly titles and meta descriptions, with one-click regeneration for more options. |
| 62 | - **Yoast AI Optimize** – Improve keyphrase placement (introduction, distribution, density) automatically. |
| 63 | - **Yoast AI Summarize** *(New 2025)* – Generate quick content summaries for briefs or social posts. |
| 64 | - **All AI tools included** – No extra accounts, limits, or hidden costs. |
| 65 | |
| 66 | These tools help you craft optimized, helpful content that resonates with readers and performs strongly across search platforms. |
| 67 | |
| 68 | --- |
| 69 | |
| 70 | ### Taking care of your technical SEO |
| 71 | |
| 72 | Yoast SEO automatically handles much of your site's technical SEO, freeing you to focus on your content. |
| 73 | |
| 74 | **Key technical SEO features:** |
| 75 | - Automated **meta tag optimization** right out of the box. |
| 76 | - **Canonical URLs** to prevent duplicate content issues. |
| 77 | - **Advanced XML sitemaps** for clear site indexing. |
| 78 | - **Best-in-class Schema.org integration** to improve search understanding and appearance. |
| 79 | - Complete **breadcrumb control** for visitors and crawlers. |
| 80 | - **Performance improvements** that help reduce load times. |
| 81 | - **Crawl settings** to manage how bots access your site and reduce environmental impact. |
| 82 | - **LLMs.txt management** to guide how large language models interact with your content. |
| 83 | |
| 84 | Every update delivers ongoing technical SEO enhancements automatically. |
| 85 | |
| 86 | --- |
| 87 | |
| 88 | ### Keep your website in perfect shape |
| 89 | |
| 90 | Whether you're a creator, business owner, or developer, Yoast SEO helps maintain your website's SEO health: |
| 91 | |
| 92 | - **Cornerstone content tools** to organize and prioritize key pages. |
| 93 | - **Front-end SEO inspector** to view and edit titles, descriptions, and schema live. |
| 94 | - **SEO roles** to delegate plugin access securely across teams. |
| 95 | - **Regular 2-week update cycle** to ensure compatibility with the latest SEO standards and search engine changes. |
| 96 | |
| 97 | --- |
| 98 | |
| 99 | ### Powerful integrations |
| 100 | |
| 101 | Yoast SEO works seamlessly with popular WordPress tools to enhance your workflow and results: |
| 102 | |
| 103 | - **[Google Site Kit](https://en-gb.wordpress.org/plugins/google-site-kit/):** Access insights from Search Console, Analytics, and PageSpeed directly inside WordPress. |
| 104 | - **[Advanced Custom Fields (ACF)](https://wordpress.org/plugins/advanced-custom-fields/):** Combine with [ACF Content Analysis for Yoast SEO](https://wordpress.org/plugins/acf-content-analysis-for-yoast-seo/) for advanced field optimization. |
| 105 | - **[Elementor](https://wordpress.org/plugins/elementor/):** Use full Yoast SEO functionality inside Elementor's editor. |
| 106 | - **[Algolia](https://wordpress.org/plugins/wp-search-with-algolia/):** Enhance internal search accuracy and performance. |
| 107 | - **[Semrush](https://www.semrush.com/):** Discover and optimize for high-value keywords. |
| 108 | - **[Wincher](https://wincher.com/):** Track keyword positions and trends in Google Search. |
| 109 | - **[Jetpack](https://wordpress.org/plugins/jetpack/):** Manage SEO and social previews all in one place. |
| 110 | - **[Easy Digital Downloads (EDD)](https://en-gb.wordpress.org/plugins/easy-digital-downloads/):** Improve digital product visibility with integrated schema. |
| 111 | - **[Mastodon](https://mastodon.social/):** Verify your website on Mastodon with Yoast SEO Premium. |
| 112 | - **[WooCommerce](https://en-gb.wordpress.org/plugins/woocommerce/):** Optimize ecommerce SEO with the dedicated WooCommerce extension. |
| 113 | |
| 114 | --- |
| 115 | |
| 116 | ## Yoast SEO Premium – AI-powered SEO for WordPress |
| 117 | |
| 118 | [Yoast SEO Premium](https://yoa.st/1v8) enhances everything in Yoast SEO with advanced automation, AI tools, and professional support. |
| 119 | Trusted by millions, it helps you optimize efficiently for both traditional and AI-driven search. |
| 120 | |
| 121 | **Tackle your SEO challenges:** |
| 122 | - Keep pace with algorithm and AI search updates. |
| 123 | - Target the right audience effectively. |
| 124 | - Automate redirects, crawl controls, and internal linking. |
| 125 | - Identify orphaned content and improve site structure. |
| 126 | - Get support when you need it. |
| 127 | |
| 128 | **Premium highlights:** |
| 129 | - AI-generated titles and meta descriptions. |
| 130 | - Smart internal linking suggestions. |
| 131 | - Social previews for Facebook and X. |
| 132 | - **Redirect Manager** with bulk tools and automatic prompts. |
| 133 | - **Bot Blocker** for AI crawlers (GPTBot, CCBot, Google-Extended). |
| 134 | - **IndexNow** integration for fast content updates. |
| 135 | - **Front-end SEO Inspector** for real-time editing. |
| 136 | - **SEO Workouts** to improve orphaned and cornerstone content. |
| 137 | - [**Google Docs add-on**](https://yoa.st/52u) for seamless SEO writing in Docs. |
| 138 | - **24/7 premium support** from SEO specialists. |
| 139 | |
| 140 | **Includes at no extra cost:** |
| 141 | - [Yoast Local SEO](https://yoa.st/1uu): Optimize for local audiences and Google Maps. |
| 142 | - [Yoast Video SEO](https://yoa.st/1uw): Ensure Google understands your videos with video sitemaps and schema. |
| 143 | - [Yoast News SEO](https://yoa.st/1uv): Increase visibility in Google News and Top Stories. |
| 144 | |
| 145 | --- |
| 146 | |
| 147 | ## Yoast WooCommerce SEO – Advanced SEO for Online Stores |
| 148 | |
| 149 | **Yoast WooCommerce SEO** builds on Yoast SEO Premium with ecommerce-specific tools to improve your store's visibility and conversion potential. |
| 150 | |
| 151 | **Key ecommerce SEO features:** |
| 152 | - **WooCommerce-specific XML sitemap** excluding non-shopping content. |
| 153 | - **Product structured data** for enhanced rich results (price, reviews, availability). |
| 154 | - **Canonical URL management** to prevent duplicates. |
| 155 | - **Ecommerce-focused content analysis** for GTINs, SKUs, and short descriptions. |
| 156 | - **AI Generate for ecommerce** – Instantly create optimized titles and meta descriptions for product and category pages. |
| 157 | |
| 158 | **Benefits:** |
| 159 | - Improve product visibility with automated structured data. |
| 160 | - Enhance crawl efficiency for large catalogs. |
| 161 | - Save time through metadata templates and automation. |
| 162 | - Increase engagement with AI-optimized ecommerce metadata. |
| 163 | |
| 164 | Built for WooCommerce, trusted by thousands of online stores worldwide. |
| 165 | |
| 166 | --- |
| 167 | |
| 168 | ## For Developers |
| 169 | |
| 170 | Yoast SEO is built with developers in mind. With modern APIs, hooks, and a unified indexables system, you can extend or integrate SEO functionality across custom themes, plugins, or headless setups. |
| 171 | |
| 172 | ### REST API |
| 173 | Retrieve SEO metadata for any post or URL, including meta tags, Open Graph, Twitter Cards, and Schema.org data. |
| 174 | [Learn more about the REST API](https://yoa.st/53l). |
| 175 | |
| 176 | ### Surfaces API |
| 177 | Access SEO data directly in code via `YoastSEO()->meta->for_current_page()`. |
| 178 | Supports titles, descriptions, canonicals, and schema. |
| 179 | [Read the Surfaces API documentation](https://yoa.st/53m). |
| 180 | |
| 181 | ### Metadata API |
| 182 | Use the [Metadata API](https://yoa.st/53n) to filter, override, or extend meta tags with WordPress hooks such as `wpseo_title`, `wpseo_metadesc`, and `wpseo_canonical`. |
| 183 | |
| 184 | ### Schema API |
| 185 | The [Schema API](https://yoa.st/53o) lets you modify or extend Schema.org graph pieces, including Article, Organization, Person, Breadcrumb, and WebPage entities. |
| 186 | |
| 187 | ### Block Editor compatibility |
| 188 | Yoast SEO integrates directly with the WordPress Block Editor (Gutenberg). |
| 189 | It outputs schema for HowTo and FAQ blocks by default, and developers can extend schema for custom blocks. |
| 190 | |
| 191 | ### Indexables |
| 192 | At the core of Yoast SEO lies the [indexables system](https://yoa.st/53q), unifying all SEO data for faster queries and consistent metadata across outputs. |
| 193 | |
| 194 | --- |
| 195 | |
| 196 | ## Ongoing support and education |
| 197 | |
| 198 | Yoast is powered by expert developers, testers, and SEO specialists who keep improving the plugin. |
| 199 | We're committed to helping users grow their SEO skills with resources such as: |
| 200 | |
| 201 | - [Yoast SEO Academy](https://yoa.st/3ri): Free and premium SEO courses (included in all paid plans). |
| 202 | - [Yoast SEO blog](https://yoast.com/seo-blog/), newsletter, and webinars. |
| 203 | - [Yoast SEO Update podcast](https://yoa.st/53i) for the latest SEO insights. |
| 204 | - [Bug reports on GitHub](https://github.com/Yoast/wordpress-seo) (for issue tracking, not support). |
| 205 | |
| 206 | **Yoast SEO** — built to make search optimization accessible, reliable, and ready for the future of AI search. |
| 207 | |
| 208 | == Installation == |
| 209 | Starting with Yoast SEO consists of just two steps: installing and setting up the plugin. Yoast SEO is designed to work with your site’s specific needs, so don’t forget to go through the Yoast SEO first-time configuration as explained in the ‘after activation’ step! For the most up-to-date guidance on how to install Yoast SEO products, [please visit our help center](https://yoast.com/help/yoast-installation-manuals/#h-yoast-seo-and-yoast-seo-premium-for-wordpress). |
| 210 | |
| 211 | == Frequently Asked Questions == |
| 212 | |
| 213 | = How do the XML Sitemaps in the Yoast SEO plugin work? = |
| 214 | |
| 215 | Having an XML sitemap can be beneficial for SEO, as Google can retrieve essential pages of a website very fast, even if the internal linking of a site isn’t flawless. |
| 216 | The sitemap index and individual sitemaps are updated automatically as you add or remove content and will include the post types you want search engines to index. Post Types marked as noindex will not appear in the sitemap. [Learn more about XML Sitemaps](https://yoa.st/3qt). |
| 217 | |
| 218 | = How can I add my website to Google Search Console? = |
| 219 | |
| 220 | It is straightforward to add your website to Google Search Console. |
| 221 | 1. Create a Google Search Console account and login into your account. |
| 222 | 2. Click ‘Add a property’ under the search drop-down. |
| 223 | 3. Enter your website URL in the box and click ‘Continue’. |
| 224 | 4. Click the arrow next to ‘HTML tag’ to expand the option. |
| 225 | 5. Copy the meta tag. |
| 226 | 6. Log in to your WordPress website. |
| 227 | 7. Click on ‘SEO’ in the dashboard. |
| 228 | 8. Click on ‘General’. |
| 229 | 9. Click on the ‘Webmaster Tools’ tab. |
| 230 | 10. Paste the code in the Google field and click ‘Save Changes’. |
| 231 | 11. Go back to Google Search Console and click ‘Verify’. |
| 232 | |
| 233 | If you want more details steps, please visit [our article on our help center](https://yoa.st/3qu). |
| 234 | |
| 235 | = How do I implement Yoast SEO breadcrumbs? = |
| 236 | |
| 237 | The steps below are a temporary solution as manual edits made to theme files may be overwritten with future theme updates. Please contact the theme developer for a permanent solution. We’ve written an article about the [importance of breadcrumbs for SEO](https://yoa.st/3qv). |
| 238 | |
| 239 | To implement the [breadcrumbs](https://yoa.st/3qw) function in Yoast SEO, you will have to edit your theme. We recommend that prior to any editing of the theme files, a backup is taken. Your host provider can help you take a backup. |
| 240 | Copy the following code into your theme where you want the breadcrumbs to be. If you are not sure, you will need to experiment with placement: |
| 241 | |
| 242 | <code> |
| 243 | <?php |
| 244 | if ( function_exists( 'yoast_breadcrumb' ) ) { |
| 245 | yoast_breadcrumb( '<p id="breadcrumbs">','</p>' ); |
| 246 | } |
| 247 | ?> |
| 248 | </code> |
| 249 | |
| 250 | Common places where you could place your breadcrumbs are inside your `single.php` and/or `page.php` file just above the page’s title. Another option that makes it really easy in some themes is by just pasting the code in `header.php` at the very end. |
| 251 | |
| 252 | In most non-WooTheme themes, this code snippet should not be added to your `functions.php` file. |
| 253 | Alternatively, you can manually add the breadcrumb shortcode to individual posts or pages: `[wpseo_breadcrumb]` |
| 254 | |
| 255 | If you need more details or a step by step guide, read our [Implementation guide for Yoast SEO breadcrumbs](https://yoa.st/3qx). |
| 256 | |
| 257 | = How do I noindex URLS? = |
| 258 | |
| 259 | Yoast SEO provides multiple options for setting a URL or group of URLs to noindex. [Read more about how to do this in this guide](https://yoa.st/3qy/). |
| 260 | |
| 261 | = Google shows the wrong description, how do I fix this? = |
| 262 | |
| 263 | If you’ve crafted nice meta descriptions for your blog posts, nothing is more annoying than Google showing another description for your site completely in the search result snippet. |
| 264 | |
| 265 | Possible causes could be: |
| 266 | 1. wrong description in code |
| 267 | 2. Google cache is outdated |
| 268 | 3. Search term manipulation |
| 269 | 4. Google ignored the meta description |
| 270 | |
| 271 | You can [read more here on how to solve the issue with the wrong description](https://yoa.st/3qz). |
| 272 | |
| 273 | = How often is Yoast SEO updated? = |
| 274 | |
| 275 | Yoast SEO is updated every two weeks. If you want to know why, please read [this post on why we release every two weeks](https://yoa.st/3q-)! |
| 276 | |
| 277 | = How do I get support? = |
| 278 | |
| 279 | As our free plugin is used by millions of people worldwide, we cannot offer you all one on one support. If you have trouble with the Yoast SEO for WordPress plugin, you can get help on the support forums here at [wordpress.org](https://wordpress.org/support/plugin/wordpress-seo/) or by checking out our help center at [yoast.com/help/](https://yoa.st/3r1). |
| 280 | |
| 281 | The plugins you buy at Yoast are called ‘premium plugins’ (even if Premium isn’t in its name) and include a complete year of free updates and premium support. This means you can contact our support team if you have any questions about that plugin. |
| 282 | |
| 283 | [Read more on how to get support](https://yoa.st/3r2) |
| 284 | |
| 285 | = What happens to my data if I enable usage tracking? = |
| 286 | |
| 287 | [This page on yoast.com explains what data we collect to improve Yoast SEO](https://yoa.st/4w7). We only collect data when you explicitly opt in. Read more about how we handle your data in [our Privacy Policy](https://yoa.st/4w8). |
| 288 | |
| 289 | = I have a different question than listed here = |
| 290 | |
| 291 | Your question has most likely been answered on our help center: [yoast.com/help/](https://yoa.st/1va). |
| 292 | |
| 293 | == Screenshots == |
| 294 | |
| 295 | 1. The modern interface makes Yoast SEO easy to work with. |
| 296 | 2. Easily manage how your posts and pages appear in SERPs. |
| 297 | 3. Yoast SEO Premium has extra crawl optimization options. |
| 298 | 4. Yoast SEO integrates with tools like Semrush and Wincher. |
| 299 | 5. The famous SEO and readability analyses in Yoast SEO. |
| 300 | 6. See what your post looks like in Google. |
| 301 | 7. The First-time configuration helps you get started quickly. |
| 302 | 8. The inclusive language analysis in Yoast SEO. |
| 303 | |
| 304 | == Changelog == |
| 305 | |
| 306 | = 27.1.1 = |
| 307 | |
| 308 | Release date: 2026-03-03 |
| 309 | |
| 310 | #### Bugfixes |
| 311 | |
| 312 | * Fixes a bug where Schema aggregator endpoints were returning a fatal error when trying to access response pages other than the first one by using slash syntax. |
| 313 | |
| 314 | = 27.1 = |
| 315 | |
| 316 | Release date: 2026-03-03 |
| 317 | |
| 318 | New: Introducing the Schema Aggregation feature. Futureproof your website for an agentic future. [Read the full release post here](https://yoa.st/55i). |
| 319 | |
| 320 | #### Enhancements |
| 321 | |
| 322 | * Introduces the Schema aggregation feature. Thanks to Syde for helping us with testing it! |
| 323 | * Introduces a more robust HTML processing and highlighting approach for the *transition words* assessment. |
| 324 | |
| 325 | #### Bugfixes |
| 326 | |
| 327 | * Fixes a bug where sentences containing transition words failed to be highlighted in _transition words_ assessment when they contained elements excluded from the analysis such as `<code>`. |
| 328 | * Fixes a bug where Slovak two-part transition words weren't recognized when running the readability analysis. |
| 329 | |
| 330 | = 27.0 = |
| 331 | |
| 332 | Release date: 2026-02-17 |
| 333 | |
| 334 | Yoast SEO 27.0 brings more enhancements and bugfixes. [Find more information about our software releases and updates here](https://yoa.st/releases). |
| 335 | |
| 336 | #### Enhancements |
| 337 | |
| 338 | * Introduces an `images` array attribute to FAQ and How-to blocks to allow for explicit image handling. |
| 339 | * Integrates `html-react-parser` to improve HTML string handling within React components. |
| 340 | * Migrates FAQ block question and answer fields from arrays to HTML strings to improve compatibility with WordPress components. |
| 341 | * Migrates How-to block step name and text fields from arrays to HTML strings to improve compatibility with WordPress components. |
| 342 | * Refines the design of the search appearance mode switcher. |
| 343 | |
| 344 | #### Bugfixes |
| 345 | |
| 346 | * Fixes a bug where the inline link icon was missing when editing a synced pattern in the Block Editor on WordPress 6.9. |
| 347 | * Fixes a bug where the AI Optimize buttons remained active even when another button had been pressed. |
| 348 | * Fixes a bug where the subheading distribution assessment threw an error when the content contained text without subheadings followed by a block that included a subheading (such as a Table of Contents block). |
| 349 | |
| 350 | #### Other |
| 351 | |
| 352 | * Updates the design of the `Generate 5 more` button and the preview background within the AI generator. |
| 353 | * Modernizes plugin translation handling by removing obsolete `load_plugin_textdomain()` calls. |
| 354 | * Restores the visibility of the suggestions title and the `Generate 5 more` button while suggestions are in the loading state. |
| 355 | * Renames the Yoast SEO AI+ card on the plans page for better clarity. |
| 356 | |
| 357 | = Earlier versions = |
| 358 | For the changelog of earlier versions, please refer to [the changelog on yoast.com](https://yoa.st/yoast-seo-changelog). |
| 359 |