AuditWidget

Install guide

Add the SEO audit widget to WordPress

Three blocks below: the snippet, the exact menu path, and the paste location. Total time: 5 minutes. No plugin. Works with Gutenberg and Elementor.

embed snippet · paste into WordPress

<script src="https://auditwidget.app/embed.js?utm_source=embed_guide&utm_medium=wordpress"
        data-token="YOUR_TOKEN"
        data-width="100%"
        data-theme="light">
</script>

Replace YOUR_TOKEN with the token from your dashboard. No account yet? Get one free →

Step 1

Open Pages → Edit the page you want the widget on

Log in at yoursite.com/wp-admin. In the left sidebar, click Pages, then click Edit on the page where the widget should appear (services, landing page, blog post — anywhere with traffic).

Screenshot mockup of the WordPress admin sidebar showing the Pages menu item highlighted.
Menu path: wp-admin → Pages → click Edit on your target page
Step 2

Click the + button → search "Custom HTML" → click the block

This is the step most people miss. WordPress strips <script> tags out of regular paragraph blocks. You need a Custom HTML block specifically. Click the + anywhere on the page, type Custom HTML, and click the result.

Screenshot mockup of the WordPress block inserter searching for Custom HTML.
Path: + (Add block) → search "Custom HTML" → click the highlighted result

Using Elementor instead?

Drag an HTML widget from the elements panel onto your page and paste the snippet there. The rest works the same.

Step 3

Paste the snippet, click Update

Paste the snippet you copied above into the Custom HTML field. Then click Update in the top-right corner (or Publish if it's a new page). Open the live page in a new tab — the widget renders inline where the block sits.

Screenshot mockup of the WordPress editor with the snippet pasted in a Custom HTML block.
Paste location: inside the Custom HTML block · Then: click Update (top-right)

Did it work?

Open the published page in a new tab. You should see the audit form rendered inline. If it's blank, open DevTools → Console and look for an error — 9 times out of 10 it's a typo'd token.

Common gotchas

"I pasted it but nothing shows up"

You probably pasted into a Paragraph block. WordPress strips script tags from paragraphs. Delete that block, add a Custom HTML block, paste again.

"I'm on WordPress.com — does this work?"

Only on the Business plan ($25/mo) or higher. Free, Personal, and Premium WordPress.com plans block custom HTML and external scripts. Self-hosted WordPress (.org) works on any setup.

"Will my caching plugin break it?"

No. The widget loads at runtime from auditwidget.app, so WP Rocket / W3 Total Cache / LiteSpeed don't affect it.

"What about my Lighthouse score?"

The script is ~8KB and loads async. It doesn't block render.

Other platforms

Webflow install → Squarespace install → Live demo →

Need a token?

Free plan, no card required. Your widget is live in under 5 minutes.

Create free account