Figma Design in Jira - error message while linking

Hi @Celine_Figma, this worked indeed, even without using the Figma for Jira plugin.

Thank you!

@Celine_Figma I’m experiencing the same issue on my end and followed your recommended steps. However, while the Figma connection shows up on my Atlassian account, it doesn’t appear on my Figma account (see screenshots below). I still revoked the app connection from Atlassian and reconnected it, but it didn’t resolve the issue.

Do you have any suggestions on how to further troubleshoot this? Worth mentioning that in our case this issue isn’t isolated to my account, most of my colleagues are also experiencing it.

Hey @Mederic, sorry to hear you’re still having trouble with this!

I took a look at the Figma account associated with your forum account, and it looks like you have a Dev mode viewer restricted seat. After installing the Figma for Jira add-on, a Jira admin must first authenticate through Figma using the Dev Mode plugin. This requires the Jira admin to have a Dev Mode seat or start a Dev Mode trial.

More info here:

Hey there,

I have an issue related. When I try to put the link this error message appears: 

I tried the same solution above, but it didn't fix the issue. I also disconnected and reconnected the Figma account, which didn't solve it either.

Hey ​@Alfredo Miranda , 
Thank you for flagging this. After checking internally with the engineering team, it sounds like you may connect the wrong Figma account.

Could you please try to revoke the Figma for Jira access token on Figma.com? Here's how:

1. Go to Settings -> Security
2. Scroll down to Connected Apps
3. Revoke Figma for Jira

 
Once this is done, when you attempts to attach a design link in Jira, you should be prompted to go through the OAuth flow again. If you are not, it’s possible your Jira account is currently connected to a different Figma account.
 
(This usually happens when you logged into multiple Figma accounts on your work device. If that’s the case, you might have accidentally linked the wrong account to Jira. During the next OAuth flow with Figma for Jira, please ensure the correct account is selected.)


 Please let us know if it works!

Sharing another use case:

Error: You do not have the required permissions in Figma to link this design. 

 
ROOT CAUSE:
From the implementation perspective, the You do not have the required permissions in Figma to link this design. error is shown, when the Figma for Jira app received HTTP 401 or HTTP 403 from Figma's GET/v1/files/:key endpoint.

I tried to link the same design to my Jira instance and inspected a response from Figma's GET/v1/files/:key endpoint. The response is the following:
 

{  "status": 403,  "err": "File not exportable"} 

From our investigation, this error indicates that that a user has permissions to view the design but the design export is restricted. As a result, the Figma for Jira app is ** __ not allowed to fetch the design, and, therefore, it cannot be linked.
 
SOLUTION

Therefore, in order to link a design, a Figma account needs to have Can view permission with the Viewers can copy, share, and export from this file setting enabled.

Please, pay attention that the Viewers can copy, share, and export from this file setting is applicable only to Figma accounts on paid plans as the free plan does not have an ability to disable this setting.

Please, see the official Figma documentation for more details on how to change the setting: Restrict copying and sharing on files
 
WORKAROUND

In case the user is not able to receive the required permission, please, consider linking the whole Figma File instead of a specific Figma Node.

1. Note a design URL.

2. Remove the node-id parameter from the design URL. As an example for the target design:

Instead of figma.com/design/S2XvcHd3RIVlePPcblu9rA/4.-🧩UI-Components?node-id=8371-32383&t=OFPZLTfBRcC4sr6o-4

Please, use:

figma.com/design/S2XvcHd3RIVlePPcblu9rA/4.-🧩UI-Components

3. Link the Figma File to a Jira Issue using the result URL.

The workaround works because when a Figma File is linked, the Figma for Jira app calls an optimised API to fetch only the File metadata (instead of all design details). Therefore, the export permission is not required.
 
Hope this helps. 

Best regards,

Mahtab
Jira Cloud Support