To track a visual UI bug in Jira, create a bug work item with clear reproduction steps, separate actual and expected results, and attach a screenshot directly to the work item. The screenshot shows what went wrong; the written context helps someone else reproduce and fix it.
1. Check whether the bug is already reported
Search the Jira project or work items for the affected page or component and the visible symptom before creating a new report. Atlassian recommends searching for existing work items first: Jira work items and issue types.
As an Amazon Associate I earn from qualifying purchases.
2. Create a bug report someone can reproduce
Choose the bug-report path for an identified bug. Atlassian distinguishes a bug report from a suggestion about product behavior or a support request for help. Use a title that identifies both the location and the failure, such as Checkout: selected shipping option loses focus outline. Atlassian’s Jira guidance
Recommended Free Tools
Include the context and steps
In the description, record the page or component, relevant browser or device, viewport if known, and any account or page state needed to reach the problem. Then list the actions in order. Do not guess at environment details; mark unknowns as unknown.
#1 Best Overall
Separate what happened from what should happen
- Actual result: Describe the visible element and its state after following the steps.
- Expected result: Describe what the interface should display or how it should behave.
This is a practical report structure, not an Atlassian-mandated schema. Atlassian’s guidance is to provide enough detail in the work-item description to help the person resolving it. Write and format work items
Copyable visual-bug template
Summary: [Page/component] — [visible defect]
Environment: [Browser/device, viewport, account state; record only what is known]
Preconditions: [State needed to reach the affected view]
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Repair Windows errors before they cause bigger problems3Fix the driver behind crashes, sound loss and screen glitchesSteps to reproduce:
- [First action]
- [Next action]
- [Action that exposes the defect]
Actual result: [What appeared]
Expected result: [What should appear]
Evidence: Screenshot attached to this work item; [identify the relevant region if helpful]
3. Attach screenshot evidence to the Jira work item
In Jira Cloud, you can drag an image or file onto the work item or use the attachment controls. Images and files can also be added in descriptions, comments, and other long text fields. Labels may vary as Atlassian rolls out changes to the work-item experience. Add content to work items · Attach files and screenshots
- Save or open the bug work item.
- Drag the screenshot onto the work item, or use its Add/Attachment control.
- Wait for the upload to finish, then confirm that the attachment appears and its preview opens.
- Check that the intended triage team can access it.
If a short recording communicates the sequence more clearly and team policy allows it, Jira supports video files among attachments. Jira attachment guidance
Upload the file to Jira, not only to an external host
An externally hosted image can disappear or become inaccessible when permissions change. Download it and attach it directly to the work item so the evidence is stored in Jira’s media system. Atlassian recommends using the attachment feature when an image preview is unavailable. Troubleshoot unavailable image previews
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →4. Check Jira settings and attachment limits if the upload fails
Permissions and field visibility
Attachments are enabled by default in Jira Cloud, but an administrator can change attachment settings or disable them. A custom permission scheme may require the Create Attachments permission. If the file must be attached while creating a work item, the Attachment field must not be hidden for that work type. Ask a Jira administrator to check these settings if the attachment control is missing or the upload is denied. Configure file attachments
Confirm the configured file-size limit
Atlassian’s current Cloud documentation does not give one consistent default: its add-content page says 10 MB, while its attachment and administration pages report 1 GB as the default and a configurable maximum of 2 GB per file. Check the limit configured for your site and the specific Jira page that applies rather than treating any one figure as universal. Add content to work items · Attach files and screenshots · Configure file attachments
Atlassian’s attachment administration documentation lists Jira Free storage as 2 GB per app, Standard as up to 250 GB per app, and Premium as unlimited. These are documented plan details and may change; confirm the current allowance for your site in Atlassian’s documentation. Configure file attachments
Keep copied images available
Copying or pasting an image between multi-line fields can create a soft link to the original attachment. If the original is removed, the copied occurrence may no longer work. When you need an independent copy, copy the image itself so Jira uploads a duplicate attachment. Atlassian image-preview troubleshooting
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Expect a list for heavily attached work items
On a work item with more than 150 attachments, Jira displays attachments as a list. This can affect how reviewers find the relevant image. Atlassian’s page describing this behavior was updated September 26, 2025. Attach files and screenshots
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.5. When to consider a screenshot API
Jira’s native attachment workflow is enough to report a defect when you already have a screenshot file. If your team needs repeatable captures from URLs, a screenshot API can generate evidence before you attach it to Jira. Choose based on how capture fits your workflow, whether all intended reviewers can access the resulting image, browser and test-process compatibility, and your security, permissions, and retention requirements. No particular Marketplace app is recommended here.
ScreenshotNeo is a website screenshot API and MCP server for developers. It is useful when a clean capture is needed: it can accept cookie/consent banners and remove more than 60 known consent platforms, newsletter popups, and chat widgets before capture. Each step can be turned off. Only clean shots are billed; bot checks/CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, with the response indicating the page verdict and billing status. Its MCP server offers screenshot tools for AI agents. These capabilities can help prepare evidence, but you still need to attach the resulting file to Jira.
Or skip the browser setup
One GET request can capture a page as an image or PDF. This cURL example saves a WebP screenshot; replace the URL with the page you need to document. See the ScreenshotNeo API documentation for request options.
Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpFor Python:
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)For Node.js:
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);ScreenshotNeo removes cookie banners, popups, and chat widgets before the shot; bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots. The Free plan includes 1,000 screenshots per month with no card, and paid plans start at $5 for 3,000. After capture, upload the file to the Jira work item so reviewers can access it there. Sign up for ScreenshotNeo free.
Frequently Asked Questions
Why can a Jira screenshot preview be unavailable?
The image may be externally hosted and inaccessible, or its original attachment may have been removed after a copied occurrence was linked to it. Upload the image directly to Jira; for a copied image that needs to remain independent, copy the image itself so Jira creates a duplicate attachment.
Can I attach a video as evidence for a visual bug?
Jira supports video files among attachments. Use a short recording when it clarifies the sequence and your team’s policy permits it.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
