LanternDocs
Sign up

WordPress Plugin

The Lantern WordPress plugin is the easiest way to install the Lantern widget on a WordPress site. It adds a settings page inside WordPress admin where you can enter the embed key — no theme file editing required.

#What the plugin does

  • Adds the Lantern widget script tag to every page of the WordPress frontend
  • Provides a settings screen under Settings → Lantern in wp-admin
  • Only shows the widget to logged-in WordPress users (auth gate is built in)

#Requirements

  • WordPress 5.0 or later
  • PHP 7.4 or later
  • A Lantern account with at least one client configured

#Installation

The plugin is live at wordpress.org/plugins/lanternhq-bug-reporter.

  1. In your WordPress admin, go to Plugins → Add New.
  2. Search for Lantern (or LanternHQ Bug Reporter).
  3. Click Install Now, then Activate.

#Manual installation

  1. Download the plugin ZIP from wordpress.org/plugins/lanternhq-bug-reporter or lanternhq.app/wordpress.
  2. In wp-admin, go to Plugins → Add New → Upload Plugin.
  3. Upload the ZIP file and click Install Now.
  4. Click Activate Plugin.

#Configuration

After activation:

  1. Go to Settings → Lantern in your WordPress admin.
  2. Enter your Embed Key — find this in your Lantern workspace under Clients → [your client] → Embed.
  3. Click Save Settings.

The widget will now appear on the frontend for all logged-in WordPress users.

#Testing

  1. Log into WordPress.
  2. Visit the frontend of the site (e.g. the homepage).
  3. You should see the Lantern widget button.
  4. Submit a test issue and confirm it appears in your Lantern workspace.

#Uninstalling

  1. In wp-admin, go to Plugins.
  2. Deactivate and then delete the Lantern plugin.

The plugin settings (embed key) are removed when the plugin is deleted. No data is sent to Lantern on uninstall.

#Updating the embed key

If you regenerate the embed key in Lantern (e.g. for security reasons), update it in the plugin settings:

  1. Go to Settings → Lantern.
  2. Replace the old key with the new one.
  3. Save.

The widget will use the new key immediately.

#Troubleshooting

Widget not appearing:

  • Confirm you are logged into WordPress and browsing the frontend (not wp-admin)
  • Go to Settings → Lantern and confirm an embed key is saved
  • Check the page source for the <script src="https://lanternhq.app/widget.js" ...> tag
  • Open the browser console and look for errors

Settings page not visible:

  • Confirm the plugin is activated (not just installed)
  • Confirm your WordPress user has Administrator access

Conflict with other plugins:

  • Some caching plugins may cache the page before the widget script is injected. Clear all caches after installing the Lantern plugin.
  • If using a Content Security Policy plugin, ensure lanternhq.app is allowed as a script source.