Add AuditWidget to WordPress

5 minutes. No plugin required. Works with the block editor (Gutenberg).

Most WordPress agencies I talk to copy the script tag into a page and wonder why nothing shows up. The catch: you can't paste HTML into a regular paragraph block. You need a Custom HTML block. Here's the exact sequence.

Get your embed code

<script
  src="https://auditwidget.app/embed.js"
  data-token="your_token_here"
  data-theme="light"
  data-width="100%">
</script>

No account yet? Create one free →

Open the page you want to edit

Go to Pages (or Posts) in your WordPress admin. Click Edit on the page where the widget should appear. Good candidates: your services page, an "audit your site" landing page, or your homepage.

If you don't have a dedicated page yet, create a new one: Pages → Add New.

Add a Custom HTML block

This is the step most people miss. You can't paste a script tag into a text block — WordPress strips it.

a. Click the + button where you want the widget to appear
b. Type Custom HTML in the search field
c. Click the Custom HTML block (not "HTML anchor")
d. Paste your embed code into the code field

Using Elementor?

Drag an HTML widget onto your page and paste the script there. It works the same way.

Publish and verify

Click Update (or Publish if it's a new page). Open the page in a new tab. The widget should appear inline where you placed the block.

If nothing shows up, open browser DevTools → Console and look for errors. The most common cause: the token is missing or typed incorrectly.

Common questions

Does this work with WordPress.com?

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

Can I put it in my header or sidebar instead of on a page?

Yes. Go to Appearance → Widgets, add a Custom HTML widget, and paste the code there. Or use the Theme Editor to add it to a template file — but editing templates directly is risky if you're not comfortable with PHP.

What about caching plugins?

The widget loads from auditwidget.app at runtime, so caching plugins (WP Rocket, W3 Total Cache) don't affect it. If you're seeing stale content, it's usually a browser cache issue, not server cache.

Will it slow down my site?

The script is about 8KB, loads async, and doesn't block page render. Your Lighthouse score won't take a hit.

Setup guides for other platforms

Webflow Squarespace Live demo