Atlassian Marketplace
Install IssueCapture via Atlassian Marketplace
Connect IssueCapture to Jira through the Atlassian Marketplace listing. No Jira app to install. You connect with OAuth 2.0 and add the widget script.
Quick Summary
Time: ~10 minutes (7 steps)
Prerequisites: Jira Cloud + access to your website
Method: OAuth 2.0 + widget script tag
Works with: Jira Software and Jira Service Management
Prerequisites
- Atlassian account with access to Jira Cloud
- Permission to authorize OAuth apps in Jira (Jira admin or equivalent)
- Access to your website's HTML or your tag manager
- IssueCapture account (free — includes 10 issues/month)
No Jira app install required
IssueCapture is a non-installable integration. The Marketplace listing redirects you to IssueCapture, where you connect Jira via OAuth 2.0. You will not see an installed app inside Jira.
Step-by-Step Installation
Follow these steps to get up and running in minutes.
1
Open the Marketplace listing
Start from Atlassian Marketplace and launch the setup flow
- Go to marketplace.atlassian.com and search for "IssueCapture"
- Open the IssueCapture listing
- Click "Get it now" or "Visit vendor" — both kick off the same flow
- Sign in with your Atlassian account if prompted
2
Create or sign in to IssueCapture
You'll be handed off to issuecapture.com to finish setup
- You'll be redirected to issuecapture.com
- Create a free account or sign in (the free plan includes 10 issues/month)
- Verify your email if this is a new account
- Continue to the dashboard
3
Connect Jira via OAuth 2.0
Authorize IssueCapture to create issues in your Jira site
- In the IssueCapture dashboard, open Settings → Configuration
- Click "Connect Jira"
- Pick your Jira Cloud site and approve the OAuth permissions
- You need to be a Jira admin (or have permission to authorize OAuth apps) for the consent prompt to succeed
4
Choose project and issue type
Decide where IssueCapture should create the issues
- Pick the Jira project the widget should write to
- Choose an issue type (Bug / Task / Story for Jira Software, or a Request type for Jira Service Management)
- Confirm any required fields the widget should send by default
- Save the configuration
5
Create a widget and allowlist your domains
Generate the API key and lock it to your site
- Open the Widgets page and click "Create widget"
- On the widget detail page, click the "Keys" tab and copy the API key (starts with "ic_")
- Click the "Domains" tab and add your site domain(s) — add both www and non-www if you serve both
- Optionally use the Theme and Form tabs to customise look and required fields
6
Install the widget script
Paste the snippet into your site's HTML and ship it
- Paste the snippet right before the closing </body> tag
- Replace ic_YOUR_API_KEY_HERE with the key from Step 5
- The widget is an ESM module — type="module" is required (don't drop the attribute)
- Deploy your site (or publish via your CMS/tag manager) and confirm the floating button appears
<!-- IssueCapture Widget (ESM module) -->
<script type="module">
import IssueCapture from 'https://issuecapture.com/widget.js';
IssueCapture.init({ apiKey: 'ic_YOUR_API_KEY_HERE' });
</script>7
Submit a test issue
Confirm the integration end-to-end
- Click the floating Report Issue button on your site
- Submit a sample issue with the screenshot tool
- Open Jira and confirm the issue landed in the project you picked in Step 4
- Once you're happy, share the widget with the rest of your team
Troubleshooting
Common integration issues and how to solve them.
No install button on the Marketplace listing
- IssueCapture is a non-installable integration — the Marketplace listing is informational and links out to issuecapture.com
- Click "Visit vendor" or "Get it now" to start setup
- There's no Jira-side app to install — everything happens via OAuth from the IssueCapture dashboard
OAuth connection fails or stalls on the consent screen
- You need to be a Jira admin, or your admin has to allow OAuth app authorization for your site
- Allow popups and third-party cookies for atlassian.net and id.atlassian.com
- If you've disconnected before, click "Reconnect Jira" from Settings → Configuration to refresh the OAuth scopes
Widget button doesn't appear on your site
- Open DevTools console and type `IssueCapture` — if the global is defined, the script loaded and something else is hiding the button (CSS / ad blocker)
- If the global is undefined, the script didn't load — check the Network tab for a 200 on widget.js
- Confirm the API key is right and starts with "ic_"
- In the IssueCapture dashboard, click your widget's Domains tab and add the site you're testing on
Issues aren't showing up in Jira
- Settings → Configuration shows the Jira connection status — reconnect if it's marked stale
- Confirm the project and issue type from Step 4 are still valid (someone may have archived them)
- Check that any required Jira fields are being filled by the widget (use the Form tab to add defaults)
- Submit another test issue and watch the browser console for a success message