Google Tag Manager

Install with Google Tag Manager

Add bug reporting to any website without touching code. Great for WordPress, Webflow, Squarespace, Wix, Shopify, and HubSpot.

Quick Summary

Time: ~10 minutes (6 steps, including Jira OAuth)
Coding required: None — copy and paste
Prerequisites: A GTM container on your site + a Jira Cloud account
Works with: WordPress, Webflow, Squarespace, Wix, Shopify, HubSpot

Prerequisites

  • Google Tag Manager container installed on your site
  • Jira Cloud account (Software or Service Management)
  • IssueCapture account (free — includes 10 issues/month)

Works With Every Major Platform

If your CMS supports GTM, it supports IssueCapture. Each card links to the vendor's own current install guide — those stay up to date as their UI shifts.

W
WordPress
Use a GTM plugin like "GTM4WP" — the official Tag Manager for WordPress plugin
W
Webflow
Add your GTM snippet in Webflow Project Settings → Custom Code
S
Squarespace
Add GTM via Settings → Developer Tools → Code Injection
W
Wix
Add GTM through Wix's Marketing Integrations panel
S
Shopify
Add GTM through Customer Events or in Online Store → Themes → Edit Code
H
HubSpot
Add the GTM snippet in Settings → Website → Pages → Site Header HTML

Don't have Google Tag Manager yet?

GTM is free and walks you through the install. The official Google setup guide below shows you how to create a container and add the GTM snippet to your site.

Set up Google Tag Manager

Step-by-Step Installation

Follow these steps to get up and running in minutes.

1

Get Your API Key

Sign up for IssueCapture and grab your widget API key

  • Go to issuecapture.com/signup and create a free account
  • Connect your Jira instance via OAuth (about 30 seconds)
  • Open the Widgets page and create a new widget
  • Copy the API key — it starts with "ic_"
2

Open Google Tag Manager

Access your GTM container

  • Go to tagmanager.google.com
  • Select your website's container (or create one if you don't have one yet)
  • Click "Add a new tag" — or the "New" button in the Tags section
3

Create a Custom HTML Tag

Paste the IssueCapture widget code into GTM

  • Click "Tag Configuration" and choose "Custom HTML"
  • Copy the snippet below and paste it into the HTML field
  • Replace ic_YOUR_API_KEY_HERE with your actual API key from step 1
  • Name the tag something like "IssueCapture Widget"
<script type="module">
  import IssueCapture from 'https://issuecapture.com/widget.js';

  IssueCapture.init({
    apiKey: 'ic_YOUR_API_KEY_HERE',
  });
</script>
4

Set the Trigger

Choose where the widget should load

  • Click "Triggering" under the tag configuration
  • Pick "All Pages" to load on every page (recommended)
  • Or create a custom trigger if you only want the widget on certain pages
  • Click "Save" when you're done
5

Allow Your Domain

Tell IssueCapture which sites can use this API key

  • In the IssueCapture dashboard, open your widget
  • Click the "Domains" tab
  • Add your site's domain (e.g. yoursite.com) — add both www and non-www versions if you serve both
  • Add localhost too if you want to test locally before publishing
6

Publish & Verify

Push your GTM changes live and confirm it loaded

  • Click "Submit" in the top right of GTM (Save alone is not enough — Submit is the publish step)
  • Give it a version name like "Added IssueCapture widget" and click Publish
  • Open your site in a new tab — you should see the Report Issue button
  • Open your browser console and type IssueCapture — you should see the widget object, which confirms the script loaded even if an ad blocker is hiding the button
  • Click the button and submit a test issue end-to-end to confirm it lands in Jira

Customise Your Widget

Almost everything is configured in the IssueCapture dashboard — you don't need to touch the GTM snippet again once it's installed.

In the Dashboard (recommended)

  • Button colour, shape, position, and label
  • Theme colours, font, and corner radius
  • Form fields, labels, and required-field rules
  • AI features — categorisation, triage, duplicate detection
  • Default Jira project, issue type, and assignee

In the GTM Snippet (optional overrides)

Anything you set in the snippet wins over the dashboard. Useful for pre-filling the reporter's name and email when your site already knows who's logged in.

  • Attach to your own button instead of the floating one: trigger: '#my-button'
  • Pre-fill the logged-in user: user: { name, email }
  • Override the floating-button label: button: { text: 'Feedback' }

Troubleshooting

Common integration issues and how to solve them.

Widget doesn't appear

  • Make sure you clicked "Submit" → "Publish" in GTM, not just "Save"
  • Hard-refresh the page (Cmd/Ctrl + Shift + R) or try it in an incognito window
  • Confirm GTM itself is loading: use GTM's Preview mode, or check the Network tab for gtm.js
  • Disable ad blockers — some block any script that looks like analytics
  • Open the browser console: if you see IssueCapture as a defined object, the script loaded and something CSS-side is hiding the button

"Domain not allowed" error

  • Add the domain to the Domains tab of your widget in the IssueCapture dashboard
  • Include both www and non-www if your site serves both
  • Add localhost if you're testing locally
  • Domains are matched on the browser's Origin header — subdomains need to be listed individually

Issues not appearing in Jira

  • Reconnect Jira from the dashboard if the OAuth token has expired
  • Check your monthly issue quota — the Free plan includes 10 issues/month
  • Confirm the widget shows a success message after submission (no message = check the browser console for errors)
  • Make sure the widget is wired to the right Jira project in the dashboard

Ready to get started?

Free plan includes 10 issues/month. No card needed — connect Jira, drop the snippet into GTM, you're done.

Start Free PlanView All Docs