# Figma

Embed live Figma design previews directly in Shortcut Stories, Epics, and other text fields with automatic link preview.

## Overview

The Shortcut Figma integration requires no setup - it works out of the box with any Figma account.

The Figma integration will turn any link to a Figma file within any markdown text field in Shortcut into an embedded live preview. Additionally, Figma URLs added to the External Ticket field of any Shortcut Story will appear as Figma branded links in their own section of the Story.

> **Note:** The current Figma integration does not support prototype links. Additionally, although the integration does technically support private links, Figma does not allow embeds to be displayed if the link is private. They must remain public in order to embed.
>
> See the Authentication section for reference: [https://www.figma.com/developers/embed](https://www.figma.com/developers/embed)

## Using the Figma Integration in Text Fields

1. Select any Figma URL
2. Copy/paste it into any of these text fields in Shortcut:
   * Story description and/or comment
   * Epic description and/or comment
   * Objective description
   * Iteration description
   * Project description
3. Preview or save your change - your Figma URL will include an embedded preview of the linked design:

![A Figma design embedded in a Shortcut Story](/help/assets/figma-embed.png)

## Adding Figma URLs to External Ticket Fields

1. Select any Figma URL
2. Copy/paste it into the **External Ticket** field of a Story
3. All Figma URLs will appear grouped together in the External Tickets section of a Story, with Figma branding:

![Figma and other external links on a Shortcut Story](/help/assets/figma-external-links.png)