Jira Integration with Pixtel: Attach Screenshots Directly to Issues

Pixtel's Jira integration lets you push annotated screenshots and videos directly into Jira issues — new or existing — without leaving the application. This guide covers account setup, API token generation, issue creation (simple and advanced), and using default field configs to reduce repetitive work.

Watch the tutorial: https://www.youtube.com/embed/E_5YtcydbGc

Step 1: Set Up Your Jira Account in Pixtel

1. Open a screenshot in Pixtel and annotate as needed
2. Go to Home Bar → Share → Applications and click the Jira icon
3. In the Jira Account Manager, click Add or Update
4. Fill in your Jira instance URL and account details
5. Click Authenticate — Pixtel loads your project metadata
6. Select the projects you want available, then click Save Metadata

Step 2: Generate a Jira API Token

Pixtel uses an API token rather than your password for authentication:

1. In the Jira Account Settings popup, click the "here" link — it opens Atlassian's token management page
2. Generate a new token and copy it
3. Paste it into the API Token field in Pixtel
4. Save — the token won't be shown again, so store it securely

Step 3: Create a Jira Issue

Pixtel offers two modes for issue creation:

Simple Form

Best for quick tickets where you just need the basics:

• Fill in Summary, Description, Issue Type, and Project
• Works across all linked Jira projects
• Click Create — images upload in the background

Advanced Form

For project-specific fields pulled from Jira metadata:

• Toggle between Simple and Advanced using the switch button
• Fill in required and any custom fields specific to that project
• Use Default Field Config (see Step 5) to pre-fill recurring values
• Click Create — a confirmation with the Jira ticket link appears in the status bar

Step 4: Update an Existing Issue

To attach a screenshot to a ticket that already exists:

1. Go to the Update Issue tab
2. Search by Project, Status, Issue ID, Reporter, or keyword
3. Apply filters to narrow results
4. Select the issue from the dropdown
5. Click Update — images and any comments are attached

Step 5: Set Default Field Configs

For fields that rarely change (Component, Environment, Reporter), save defaults to avoid filling them in every time:

1. In Advanced Create mode, check Default Field Config
2. Click the gear icon next to any field
3. Choose a default value
4. Fields auto-fill on all future issues — override any time

This is especially useful for teams that always file bugs against the same project, component, and environment.

Tips

Annotate before sharing. Add arrows, callouts, or highlights to the screenshot before opening the Share panel — the annotated version is what gets attached to the ticket.

Use Update Issue for follow-ups. When a bug gets reproduced or a new state needs documenting, use the Update Issue tab to attach the new screenshot to the existing Jira ticket rather than creating a duplicate.

Keyboard shortcut workflow. Assign a capture shortcut in User Preferences, capture the bug state, annotate, then push to Jira — the whole flow takes under 30 seconds once configured.

Related reading:

• Master Bug Reporting: Best Practices with Pixtel & Jira →
• How to Annotate Images in Pixtel →
• How to Share Captures Effortlessly with Pixtel →

Capture once and use it forever. It isn't just a tool — it's Pixtel.

👉 Download Pixtel · 📘 Documentation · 🎥 Watch Tutorial