Documentation
Install it, connect a design tool once, and keep every ticket tied to the exact design it was written against.
You can be up and running in a couple of minutes.
You only connect a design tool once per user. After that, any issue you open recognises your connection automatically.
Design Bridge uses Figma's official OAuth flow — you never paste a password or token into Jira.
The access token that results is stored securely by Atlassian Forge's encrypted storage and is scoped to your account. Design Bridge only ever reads what your own Figma account can already see — it can't widen your access.
If a teammate can't see a file you added, it's an access issue on the design tool's side — ask the file owner to share it with them, or rely on seat-free viewing (below).
Open any Jira issue and use the Design panel:
You can attach more than one design to an issue when a ticket spans several screens or boards.
Pinning is the heart of Design Bridge. When you pin, it snapshots the exact version the ticket was written against.
Change detection means a developer never silently builds against an outdated mockup. The pin holds until someone chooses to move it.
Design Bridge pulls Figma comments and shows them beside the design inside the issue.
This is what lets your whole team see the design without buying everyone a design seat.
The rendered snapshot is a static image of the pinned version, so viewers always see exactly what was agreed — not whatever the design looks like right now.
Miro boards work the same way as Figma files for the core flow:
If something looks wrong, you can fix it yourself without waiting on support.
| Plan | Team size | Price | What's included |
|---|---|---|---|
| Free | Up to 10 users | $0 | 1 connected design tool, up to 5 linked issues, unlimited seat-free viewing, pinning & comments |
| Standard | 11–100 users | $2.50 / user / month | All tools, unlimited linked issues, pinning & change detection, comments, seat-free viewing |
| Volume | Above 100 users | ~$1.20 at 500, ~$0.85 at 1,000 | Everything in Standard, with discounts applied automatically by tier |
Pricing is counted per billable Jira user, the same way Atlassian meters every Marketplace app. Annual billing is 10× the monthly rate — two months free. Billing runs entirely through the Atlassian Marketplace on your existing invoice.
The messages Design Bridge shows are written to be self-explanatory. Here's what the common ones mean.
| What you see | What it means & what to do |
|---|---|
| "Your Figma account can't see this file — ask the owner to share it." | Your connected Figma account doesn't have access to that specific file. Ask the file owner to share it with you, or view the pinned snapshot without editing access. |
| "Your connection expired — reset it to reconnect." | The stored token is no longer valid. Click Reset connection and re-approve the consent screen. |
| "This design has changed since the ticket was written." | Not an error — the pinned version differs from the current design. Review it and Re-pin to latest when you're ready. |
| "That link isn't a Figma file or Miro board we recognise." | The URL isn't a supported design link. Paste the file/board URL from Figma or Miro directly, not a share page or export link. |
| "You've reached the Free plan's 5 linked issues." | Free allows up to 5 linked issues. Upgrade to Standard for unlimited linked issues. |
Design Bridge stores metadata only — never a copy of your full design.
Read the full Privacy Policy for collection, retention and deletion details.
Need a hand? We're quick to respond.