Skip to main content
Documentation/Integrations/SEO Plugins/Rank Math
Integrations

Rank Math

Oxygen works with Rank Math out of the box. Install both plugins and
Rank Math behaves the way it does on any WordPress site: titles, meta descriptions, schema,
redirections and sitemaps all come from Rank Math, 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. Rank Math's meta box is on that
screen where it always is, whether or not the page is built with Oxygen. Set your focus
keyword, title and description there; open the builder for the layout.

Content analysis reads the real page

Rank Math's SEO tests normally analyse 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 replaces the analysed content with the page's rendered HTML: when you open the edit
screen for a post built with Oxygen, Oxygen renders that post's element tree and feeds the
resulting markup to Rank Math's content analysis. The tests that look for headings, links,
images, alt text and keyword placement all see the real page.

Oxygen also registers itself with Rank Math as a table-of-contents provider, so Rank Math's
"Table of Contents" test doesn't fail on a page whose TOC was built with elements.

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

If you use Rank Math'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 Rank Math.

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

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 Rank
Math normally, from that content.

The scores don't reflect changes I just made in the builder

The rendered content is captured when the WordPress edit screen loads. If you edit the page in
the builder in another tab, save, then return to the still-open edit screen, Rank Math is
still analysing the older markup. Reload the edit screen.

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 Rank Math.

The Breadcrumbs element says to select an integration

Its Integration control is unset. Pick Rank Math.