Skip to Main Content

New accounts get 30 days of Pro free. No credit card. Start Free

Docs / Install the Widget / WordPress

Add a Feedback Widget to WordPress

The simplest route on WordPress is a header and footer plugin, so the tags survive theme updates. Any theme works, including block themes.

Two tags, about ten minutes. The meta tag proves you own the site, and the script adds the launcher. Verification reads the HTML your server returns, so the meta tag has to be in the page source, not added later by JavaScript.

Steps

  1. Copy Your Tags From FeedBlox

    In the FeedBlox dashboard, add your site with its public URL, then open Widget. Copy the verification meta tag now. The install snippet with your site ID and embed token appears on the same page once the site is verified.

  2. Install a Header and Footer Plugin

    In WordPress, go to Plugins, Add New, and install WPCode (listed as Insert Headers and Footers). Any plugin with site-wide header and footer fields works the same way.

  3. Paste the Meta Tag in the Header

    Open the plugin's Header and Footer screen and paste the verification tag into the Header box.

    HTML 
    <meta name="feedblox-site-verification" content="YOUR_VERIFICATION_TOKEN" />

  4. Paste the Widget Script in the Footer

    After verifying, paste the install snippet into the Footer box and save.

    HTML 
    <script src="https://app.feedblox.net/widget.js" async
  data-site-id="YOUR_SITE_ID"
  data-token="YOUR_EMBED_TOKEN"
  data-api-url="https://api.feedblox.net"
  data-position="middle-right"
></script>

  5. Verify and Send a Test Report

    Back on the Widget page, click Verify Site. Then open your live site, click the launcher, and send a test report. It reaches your inbox with the console output and failed requests captured on that page. To include errors from before a visitor opens the widget, turn on Start Capturing Client Debug Early in Widget settings.

Good to Know

  • If you use a caching plugin or a CDN, clear its cache after saving, or verification sees the old page.
  • Optimization plugins that combine or delay JavaScript can hold back the widget. Exclude widget.js from those settings if the launcher does not appear.

Troubleshooting

Verification says the meta tag was not found

Open your live site, view the page source, and search for feedblox-site-verification. If it is missing, the change is not published yet, a cache is serving the old page, or the tag is being added by JavaScript after load. The Site URL in FeedBlox must be the public address, not localhost or an editor preview.

The launcher does not appear

Check that the site is verified and that the page's address matches the Site URL or one of your Additional Embed Origins. Then open the browser console and look for errors loading widget.js.

Other Platforms

Webflow , Shopify , Framer , Wix , Squarespace , Next.js , React and Vite , Lovable , Bolt , v0 , Vue , Astro , SvelteKit , Nuxt , Remix and React Router , Ghost , Bubble , Laravel , Django , or the generic install guide for any site where you can edit the HTML.