Atlassian Marketplace

Install IssueCapture via Atlassian Marketplace

Connect IssueCapture to Jira through the Atlassian Marketplace listing. No Jira app install required, just OAuth 2.0 and a simple 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

Ready to connect Jira?

Create your IssueCapture account and start collecting structured bug reports today.

Get Started FreeView All Docs