Skip to main content
Documentation/Integrations/SEO Plugins/SEOPress
Integrations

SEOPress

Oxygen works with SEOPress out of the box. Install both plugins
and SEOPress behaves the way it does on any WordPress site: titles, meta descriptions, social
metadata, schema and sitemaps all come from SEOPress, because Oxygen builds the page body and
leaves the document head to WordPress.

The one place a page builder normally breaks an SEO plugin is content analysis — and that's
the part Oxygen handles for you.

Editing SEO data

Edit the post, page or custom post type in WordPress as usual. The SEOPress meta box is on
that screen where it always is, whether or not the page is built with Oxygen. Set your target
keyword, title and description there; open the builder for the layout.

Content analysis reads the real page

SEOPress's content analysis normally reads the content in the WordPress editor. A page built
with Oxygen doesn't keep its layout there — it's stored as an element tree — so a naive
analysis would score an empty page.

Oxygen substitutes the page's rendered HTML: when SEOPress asks for the content to analyse,
Oxygen renders that post's element tree and returns the resulting markup instead. The
analysis sees the headings, paragraphs, links, images and alt text that are actually on the
page.

There's nothing to enable. It applies to every post in builder mode, on every post type.

If you use SEOPress's breadcrumbs, the Breadcrumbs element — part of the Breakdance
Elements extension for Oxygen — outputs them inside your layout. Add the element, then set its
Integration control to SEOPress.

The Breadcrumbs element selected on the canvas with its Integration control set to SEOPress

Troubleshooting

The analysis is empty, or scores a page that clearly has content

Check the post is actually in builder mode — Oxygen only substitutes the rendered content for
posts it built. A post whose layout lives in the classic editor or blocks is analysed by
SEOPress normally, from that content.

The Breadcrumbs element says to install an SEO plugin

The element prints "Please install Yoast, RankMath, or SEOPress to use breadcrumbs" when none
of the three is active — it renders whichever plugin's breadcrumb function it's pointed at
rather than building its own trail. Activate SEOPress.

The Breadcrumbs element says to select an integration

Its Integration control is unset. Pick SEOPress.