Install with Google Tag Manager
Add bug reporting to any website without touching code. Perfect for WordPress, Webflow, Squarespace, Wix, and Shopify.
Quick Summary
Prerequisites
- Google Tag Manager container installed on your site
- Jira Cloud account (Software or JSM)
- IssueCapture account (sign up free)
Works With All Major Platforms
No matter where your site is hosted, GTM makes integration easy.
Don't have Google Tag Manager yet?
GTM is free and takes 5 minutes to set up. It lets you add scripts to your website without editing code.
Set up Google Tag ManagerStep-by-Step Installation
Follow these steps to get up and running in minutes.
Get Your API Key
Sign up for IssueCapture and get your widget API key
- Go to issuecapture.com/signup and create a free account
- Connect your Jira instance via OAuth (takes 30 seconds)
- Go to the Widgets page and create a new widget
- Copy your API key (it starts with "ic_")
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)
- Click "Add a new tag" or the "New" button
Create Custom HTML Tag
Add the IssueCapture widget code
- Click "Tag Configuration" and select "Custom HTML"
- Copy the code below and paste it into the HTML field
- Replace ic_YOUR_API_KEY_HERE with your actual API key
- Name your tag something like "IssueCapture Widget"
<script type="module">
import IssueCapture from 'https://issuecapture.com/widget.js';
IssueCapture.init({
apiKey: 'ic_YOUR_API_KEY_HERE',
trigger: 'auto',
button: {
position: 'bottom-right',
text: 'Report Bug'
}
});
</script>Set the Trigger
Configure when the widget should load
- Click "Triggering" below the tag configuration
- Select "All Pages" to load on every page
- Or create a custom trigger for specific pages only
- Click "Save" to save your tag
Add Your Domain
Add your website domain to the allowlist in IssueCapture
- Go to your IssueCapture dashboard → Widgets
- Click on your widget to edit it
- Add your website domain (e.g., yoursite.com) to the allowed domains
- This prevents unauthorized use of your API key
Publish & Test
Deploy your changes and verify the widget works
- Click "Submit" in the top right of GTM
- Add a version name like "Added IssueCapture widget"
- Click "Publish"
- Visit your website - you should see the bug report button
- Click it and submit a test issue to verify it works
Customize Your Widget
You can customize the widget appearance directly in the IssueCapture dashboard - no need to change the GTM code.
In the Dashboard
- Change button color and position
- Customize form fields and labels
- Enable/disable AI features
- Set default Jira project and issue type
In GTM (Optional)
- Change button text:
text: 'Feedback' - Move button:
position: 'bottom-left' - Custom trigger:
trigger: '#my-button'
Troubleshooting
Common integration issues and how to solve them.
Widget doesn't appear
- Make sure you clicked "Publish" in GTM (not just "Save")
- Clear your browser cache or try incognito mode
- Verify GTM is installed on your website (use GTM Preview mode)
- Check browser console for JavaScript errors
"Domain not allowed" error
- Add your domain to the allowed list in IssueCapture dashboard
- Include both www and non-www versions if needed
- Add localhost for testing locally
Issues not appearing in Jira
- Verify your Jira connection in IssueCapture dashboard
- Check you have issues remaining (Free plan includes 10/month)
- Make sure the widget shows a success message after submission
Ready to get started?
Sign up for a free account and start collecting bug reports in 5 minutes. No coding required.