=== Wptopr SEO - Advanced SEO with real-time guidance and built-in AI ===
Contributors: wptopr, joostdevalk, tdevalk
Donate link: https://wptopr.com/1up
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl.html
Tags: SEO, XML sitemap, Content analysis, Readability, Schema
Tested up to: 7.0
Stable tag: 27.8
Requires PHP: 7.4

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.

== Description ==

## Wptopr SEO: The #1 WordPress SEO Plugin

Since 2008, **Wptopr SEO** has helped millions of websites worldwide improve their visibility and SEO performance.
Our mission is **SEO for Everyone** — from small local businesses to some of the most visited sites on the web.

Wptopr SEO gives you everything you need to manage your on-site SEO effectively.
The [Wptopr SEO Premium](https://wptopr.com/1v8) plugin and its extensions unlock even more advanced and AI-powered tools.

---

### Handing you the competitive edge

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, Wptopr SEO helps you handle SEO confidently and efficiently.

Don't have time to stay on top of AI search and best practices? Keeping Wptopr SEO updated means you automatically benefit from ongoing technical improvements, schema updates, and AI advancements — all guided by our signature traffic light approach.

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.

---

### Quick and easy setup

Setting up Wptopr SEO is quick and straightforward — no technical background required.
Our step-by-step configuration wizard walks you through essential setup details so Wptopr SEO can generate accurate **structured data** that helps search engines understand your site.

Switching from another SEO plugin like Rank Math or AIOSEO? Migration is seamless.
Import your existing SEO data and settings safely with our built-in import/export tools.

---

### Content and AI features

Unlock your content's full potential with Wptopr SEO's **advanced content analysis** and **AI-powered tools**.

**Content optimization features:**
- Detailed **SEO analysis** to guide keyword targeting and site performance.
- **Readability analysis** for clear, engaging, and user-friendly writing.
- **SERP previews** for both desktop and mobile results.
- **HowTo and FAQ blocks** with built-in schema support.
- **Breadcrumbs block** for improved navigation.
- **Inclusive Language Analysis** to make your content more considerate and accessible.
- **Semrush integration** for keyword research directly in Wptopr SEO.
- **Wincher integration** to track keyword performance inside your dashboard.
- **Elementor integration** for seamless optimization within your favorite builder.

**AI features (included in Premium):**
- **[Wptopr AI Generate](https://wptopr.com/51c)** – Instantly create five SEO-friendly titles and meta descriptions, with one-click regeneration for more options.
- **Wptopr AI Optimize** – Improve keyphrase placement (introduction, distribution, density) automatically.
- **Wptopr AI Summarize** *(New 2025)* – Generate quick content summaries for briefs or social posts.
- **All AI tools included** – No extra accounts, limits, or hidden costs.

These tools help you craft optimized, helpful content that resonates with readers and performs strongly across search platforms.

---

### Taking care of your technical SEO

Wptopr SEO automatically handles much of your site's technical SEO, freeing you to focus on your content.

**Key technical SEO features:**
- Automated **meta tag optimization** right out of the box.
- **Canonical URLs** to prevent duplicate content issues.
- **Advanced XML sitemaps** for clear site indexing.
- **Best-in-class Schema.org integration** to improve search understanding and appearance.
- Complete **breadcrumb control** for visitors and crawlers.
- **Performance improvements** that help reduce load times.
- **Crawl settings** to manage how bots access your site and reduce environmental impact.
- **LLMs.txt management** to guide how large language models interact with your content.

Every update delivers ongoing technical SEO enhancements automatically.

---

### Keep your website in perfect shape

Whether you're a creator, business owner, or developer, Wptopr SEO helps maintain your website's SEO health:

- **Cornerstone content tools** to organize and prioritize key pages.
- **Front-end SEO inspector** to view and edit titles, descriptions, and schema live.
- **SEO roles** to delegate plugin access securely across teams.
- **Regular 2-week update cycle** to ensure compatibility with the latest SEO standards and search engine changes.

---

### Powerful integrations

Wptopr SEO works seamlessly with popular WordPress tools to enhance your workflow and results:

- **[Google Site Kit](https://en-gb.wordpress.org/plugins/google-site-kit/):** Access insights from Search Console, Analytics, and PageSpeed directly inside WordPress.
- **[Advanced Custom Fields (ACF)](https://wordpress.org/plugins/advanced-custom-fields/):** Combine with [ACF Content Analysis for Wptopr SEO](https://wordpress.org/plugins/acf-content-analysis-for-wptopr-seo/) for advanced field optimization.
- **[Elementor](https://wordpress.org/plugins/elementor/):** Use full Wptopr SEO functionality inside Elementor's editor.
- **[Algolia](https://wordpress.org/plugins/wp-search-with-algolia/):** Enhance internal search accuracy and performance.
- **[Semrush](https://www.semrush.com/):** Discover and optimize for high-value keywords.
- **[Wincher](https://wincher.com/):** Track keyword positions and trends in Google Search.
- **[Jetpack](https://wordpress.org/plugins/jetpack/):** Manage SEO and social previews all in one place.
- **[Easy Digital Downloads (EDD)](https://en-gb.wordpress.org/plugins/easy-digital-downloads/):** Improve digital product visibility with integrated schema.
- **[Mastodon](https://mastodon.social/):** Verify your website on Mastodon with Wptopr SEO Premium.
- **[WooCommerce](https://en-gb.wordpress.org/plugins/woocommerce/):** Optimize ecommerce SEO with the dedicated WooCommerce extension.

---

## Wptopr SEO Premium – AI-powered SEO for WordPress

[Wptopr SEO Premium](https://wptopr.com/1v8) enhances everything in Wptopr SEO with advanced automation, AI tools, and professional support.
Trusted by millions, it helps you optimize efficiently for both traditional and AI-driven search.

**Tackle your SEO challenges:**
- Keep pace with algorithm and AI search updates.
- Target the right audience effectively.
- Automate redirects, crawl controls, and internal linking.
- Identify orphaned content and improve site structure.
- Get support when you need it.

**Premium highlights:**
- AI-generated titles and meta descriptions.
- Smart internal linking suggestions.
- Social previews for Facebook and X.
- **Redirect Manager** with bulk tools and automatic prompts.
- **Bot Blocker** for AI crawlers (GPTBot, CCBot, Google-Extended).
- **IndexNow** integration for fast content updates.
- **Front-end SEO Inspector** for real-time editing.
- **SEO Workouts** to improve orphaned and cornerstone content.
- [**Google Docs add-on**](https://wptopr.com/52u) for seamless SEO writing in Docs.
- **24/7 premium support** from SEO specialists.

**Includes at no extra cost:**
- [Wptopr Local SEO](https://wptopr.com/1uu): Optimize for local audiences and Google Maps.
- [Wptopr Video SEO](https://wptopr.com/1uw): Ensure Google understands your videos with video sitemaps and schema.
- [Wptopr News SEO](https://wptopr.com/1uv): Increase visibility in Google News and Top Stories.

---

## Wptopr WooCommerce SEO – Advanced SEO for Online Stores

**Wptopr WooCommerce SEO** builds on Wptopr SEO Premium with ecommerce-specific tools to improve your store's visibility and conversion potential.

**Key ecommerce SEO features:**
- **WooCommerce-specific XML sitemap** excluding non-shopping content.
- **Product structured data** for enhanced rich results (price, reviews, availability).
- **Canonical URL management** to prevent duplicates.
- **Ecommerce-focused content analysis** for GTINs, SKUs, and short descriptions.
- **AI Generate for ecommerce** – Instantly create optimized titles and meta descriptions for product and category pages.

**Benefits:**
- Improve product visibility with automated structured data.
- Enhance crawl efficiency for large catalogs.
- Save time through metadata templates and automation.
- Increase engagement with AI-optimized ecommerce metadata.

Built for WooCommerce, trusted by thousands of online stores worldwide.

---

## For Developers

Wptopr 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.

### REST API
Retrieve SEO metadata for any post or URL, including meta tags, Open Graph, Twitter Cards, and Schema.org data.
[Learn more about the REST API](https://wptopr.com/53l).

### Surfaces API
Access SEO data directly in code via `WptoprSEO()->meta->for_current_page()`.
Supports titles, descriptions, canonicals, and schema.
[Read the Surfaces API documentation](https://wptopr.com/53m).

### Metadata API
Use the [Metadata API](https://wptopr.com/53n) to filter, override, or extend meta tags with WordPress hooks such as `wpseo_title`, `wpseo_metadesc`, and `wpseo_canonical`.

### Schema API
The [Schema API](https://wptopr.com/53o) lets you modify or extend Schema.org graph pieces, including Article, Organization, Person, Breadcrumb, and WebPage entities.

### Block Editor compatibility
Wptopr SEO integrates directly with the WordPress Block Editor (Gutenberg).
It outputs schema for HowTo and FAQ blocks by default, and developers can extend schema for custom blocks.

### Indexables
At the core of Wptopr SEO lies the [indexables system](https://wptopr.com/53q), unifying all SEO data for faster queries and consistent metadata across outputs.

---

## Ongoing support and education

Wptopr is powered by expert developers, testers, and SEO specialists who keep improving the plugin.
We're committed to helping users grow their SEO skills with resources such as:

- [Wptopr SEO Academy](https://wptopr.com/3ri): Free and premium SEO courses (included in all paid plans).
- [Wptopr SEO blog](https://wptopr.com/seo-blog/), newsletter, and webinars.
- [Wptopr SEO Update podcast](https://wptopr.com/53i) for the latest SEO insights.
- [Bug reports on GitHub](https://github.com/Wptopr/wordpress-seo) (for issue tracking, not support).

**Wptopr SEO** — built to make search optimization accessible, reliable, and ready for the future of AI search.

== Installation ==
Starting with Wptopr SEO consists of just two steps: installing and setting up the plugin. Wptopr SEO is designed to work with your site’s specific needs, so don’t forget to go through the Wptopr SEO first-time configuration as explained in the ‘after activation’ step! For the most up-to-date guidance on how to install Wptopr SEO products, [please visit our help center](https://wptopr.com/help/wptopr-installation-manuals/#h-wptopr-seo-and-wptopr-seo-premium-for-wordpress).

== Frequently Asked Questions ==

= How do the XML Sitemaps in the Wptopr SEO plugin work? =

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.
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://wptopr.com/3qt).

= How can I add my website to Google Search Console? =

It is straightforward to add your website to Google Search Console.
1. Create a Google Search Console account and login into your account.
2. Click ‘Add a property’ under the search drop-down.
3. Enter your website URL in the box and click ‘Continue’.
4. Click the arrow next to ‘HTML tag’ to expand the option.
5. Copy the meta tag.
6. Log in to your WordPress website.
7. Click on ‘SEO’ in the dashboard.
8. Click on ‘General’.
9. Click on the ‘Webmaster Tools’ tab.
10. Paste the code in the Google field and click ‘Save Changes’.
11. Go back to Google Search Console and click ‘Verify’.

If you want more details steps, please visit [our article on our help center](https://wptopr.com/3qu).

= How do I implement Wptopr SEO breadcrumbs? =

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://wptopr.com/3qv).

To implement the [breadcrumbs](https://wptopr.com/3qw) function in Wptopr 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.
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:

<code>
<?php
if ( function_exists( 'wptopr_breadcrumb' ) ) {
    wptopr_breadcrumb( '<p id="breadcrumbs">','</p>' );
}
?>
</code>

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.

In most non-WooTheme themes, this code snippet should not be added to your `functions.php` file.
Alternatively, you can manually add the breadcrumb shortcode to individual posts or pages: `[wpseo_breadcrumb]`

If you need more details or a step by step guide, read our [Implementation guide for Wptopr SEO breadcrumbs](https://wptopr.com/3qx).

= How do I noindex URLS? =

Wptopr 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://wptopr.com/3qy/).

= Google shows the wrong description, how do I fix this? =

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.

Possible causes could be:
1. wrong description in code
2. Google cache is outdated
3. Search term manipulation
4. Google ignored the meta description

You can [read more here on how to solve the issue with the wrong description](https://wptopr.com/3qz).

= How often is Wptopr SEO updated? =

Wptopr SEO is updated every two weeks. If you want to know why, please read [this post on why we release every two weeks](https://wptopr.com/3q-)!

= How do I get support? =

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 Wptopr 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 [wptopr.com/help/](https://wptopr.com/3r1).

The plugins you buy at Wptopr 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.

[Read more on how to get support](https://wptopr.com/3r2)

= What happens to my data if I enable usage tracking? =

[This page on wptopr.com explains what data we collect to improve Wptopr SEO](https://wptopr.com/4w7). We only collect data when you explicitly opt in. Read more about how we handle your data in [our Privacy Policy](https://wptopr.com/4w8).

= I have a different question than listed here =

Your question has most likely been answered on our help center: [wptopr.com/help/](https://wptopr.com/1va).

== Screenshots ==

1. The modern interface makes Wptopr SEO easy to work with.
2. Easily manage how your posts and pages appear in SERPs.
3. Wptopr SEO Premium has extra crawl optimization options.
4. Wptopr SEO integrates with tools like Semrush and Wincher.
5. The famous SEO and readability analyses in Wptopr SEO.
6. See what your post looks like in Google.
7. The First-time configuration helps you get started quickly.
8. The inclusive language analysis in Wptopr SEO.

== Changelog ==

= 27.8 =

Release date: 2026-06-09

Wptopr SEO 27.8 brings more enhancements and bugfixes. [Find more information about our software releases and updates here](https://wptopr.com/releases).

#### Enhancements

* Makes the schema aggregator faster by drastically reducing the roundtrips to the database, when indexables are disabled.
* Makes the SEO optimization faster by drastically reducing the roundtrips to the database.
* Optimizes expensive DB queries when performing actions in admin pages related to SEO optimization.
* Significantly reduces loading times of the root sitemap on sites with many users.
* Reduces loading times of the author sitemap on sites with many users.
* Prevents unnecessary expensive DB queries when admin pages are being visited.

#### Bugfixes

* Ensures compatibility with the React 19 version bundled in Gutenberg 23.3 (WordPress 7.1), fixing several screens and components that could otherwise fail to render.
* Fixes a bug where NaN was set as the Primary taxonomy and triggered a console error.
* Fixes a bug where the dismiss button in the Webinar promo notice in general page was transparent.
* Improves post editor rendering performance by stabilising Redux selector and `withSelect` references in multiple components to prevent unnecessary re-renders.

#### Other

* Introduces the `wpseo_custom_fields_pre_query` filter, allowing sites to short-circuit the potentially expensive custom-fields lookup in Wptopr settings, with a pre-computed list or a custom query.
* Removes the Wptopr group from the filter bar on the WordPress plugins list.
* Sets the title of a child task to "(no title)" in the task list, when the related post has no title.

= 27.7 =

Release date: 2026-05-27

Wptopr SEO 27.7 brings more enhancements and bugfixes. [Find more information about our software releases and updates here](https://wptopr.com/releases).

#### Bugfixes

* Fixes a bug in Schema aggregator where products Schema pieces had incorrect `@id` values for `mainEntityOfPage` and `image` properties.
* Fixes a bug where a `FocusTrap` warning was thrown and the X button did not receive focus when the replace content confirmation modal from the AI Content Planner was opened.
* Fixes a bug where a warning was triggered in the console when editing a post with the Content Planner feature enabled.
* Fixes a bug where only the first piece was returned when indexables were not available.
* Fixes a bug where the AI features section was rendered twice on the user profile page.
* Fixes a bug where the block editor was crashing when some AI features were triggering errors.
* Fixes a bug where the Content Planner inline banner was displayed when editing a template or template part.

#### Other

* Makes the Academy, Upgrade and Brand insights links visible to more user roles.

= Earlier versions =
For the changelog of earlier versions, please refer to [the changelog on wptopr.com](https://wptopr.com/wptopr-seo-changelog).
