Before you start
Who can use this feature
This article covers how to create a new widget in FigJam, and is only one step in the widget development process.
The widget development process:
- Setup your development environment →
- Create a widget for development →
- Publish widgets to the Figma Community (Current article)
- Manage widgets as a developer →
You must have the Figma desktop app installed to make widgets. We recommend building widgets using TypeScript in Visual Studio Code. If you're not familiar with TypeScript, you can still build widgets with Javascript.
When you're ready to share your widget, you can publish it to the Figma Community. This allows other users to install and insert your widget into Figma design and FigJam files.
Every widget must go through a review process the first time it gets published to the Figma Community. Once the widget is approved, it'll be available in the Figma Community for users to install and use.
You won't need to go through the review process for any future updates.
Note
You need to have two-factor authentication enabled to publish widgets, including publishing updates to existing widgets. You won't need to use two-factor authentication if you sign in to Figma via SAML SSO or Google SSO.
Before you publish
Widget review process
When a widget is published for the first time, it goes through Figma's review process and must be approved to be listed in Figma Community. Learn more about Figma's plugin and widget review guidelines →
Figma will contact you via your Figma account email to notify you of our decision. Our goal is to reach a decision within 5-10 business days. If Figma rejects the widget, you can address any feedback and submit again.
Noticed a mistake in your widget? You can still publish updates to your widget during the review process.
Creators and contributors
Publishers can choose to list any other creators as part of the publishing process. This is a great way to recognize any contributions to the widget's development. To qualify as a creator, the contributor will need to have a Figma Community profile.
Figma will send a notification to anyone added as a creator, which the creator must accept or decline the request. Accepted contributors will appear on the widget's page and the widget will appear on each creator's Community profile.
Prepare widget information
Like plugins, every widget will have its own page in the Figma Community. This allows other members of the Community to find and install your widget.
You'll need to provide some information for your widget listing. We recommend getting this set up before you start the publishing process.
- Choose a name for your widget. This can be something descriptive or a little creative. Users can search for your widget using this name, but you also have tags to add relevant keywords.
- Write a tagline to describe what your widget does in a few words. Taglines are used to determine search results when searching resources in the Community. Taglines also appear in browsing and search results instead of the description. Max 50 characters per tagline.
- Create an icon to represent your widget in the Community and in files. The recommended dimensions are 128 x 128. If you upload a larger image, it will be scaled to fit as long as the icon has a 1:1 aspect ratio.
- Create some cover art for the top of your widget page. The recommended dimensions are 1920 x 960 (safe area: 1600 x 960). If you upload a larger image, it will be scaled to fit as long as the icon has a 2:1 aspect ratio.
- Include a playground file, if available. Playground files provide context on how to use your widget. This can be especially useful for widgets that are meant to be used over specific layers. Learn more about playground files →
- Write a description of your widget. Use this field to explain what the widget does, how to use it, and a sales pitch. If your widget requires a subscription, we recommended mentioning this first. You can format your description using some basic text formatting.
- Bold
- Italic
- Strikethrough
- Header 1
- Bulleted list
- Numbered list
- Add hyperlink
- Inline code
- Code block
- Add up to 12 keywords or tags to classify your widget. We support alphanumeric characters (a-z and 1-9), but no special characters or punctuation. Max 25 characters per tag.
- As a widget creator, it's your responsibility to provide support for your widgets. You'll need to provide an email address, website, or help center for your support contact.
- Widget creators and contributors need their own Community Profile to be listed on the widget listing. Learn how to create a Community Profile →
Monetization
You cannot display advertisements to users within files, or as part of a widget's UI. However, there are no restrictions around creating websites or profiles for your widget.
There isn't currently a way to monetize widgets in Figma Community itself. If you require a paid subscription, you can direct users to a third-party site from your widget description, or build your own monetization solution within your widget. Figma Community Guidelines →
Publish your widget
Widgets go through the same publishing flow the first time it is published and every time it gets updated.
When a widget is published for the first time, it must be reviewed and approved by Figma to be listed in the Community. Learn more about the widgets review process ↓
You can only publish widgets from the Figma desktop app.
Warning
Any attempts to exploit the Figma widget API will result in immediate removal. This will also ban you from publishing widgets in the future.
This includes but is not limited to: Providing false information, plagiarism, deceitful manipulation of user files, and theft of data.
To publish a widget to the Figma Community:
- Open a Figma design or FigJam file on the Figma desktop app.
- Click in the top-left corner, then go to Widgets > Development > Manage widgets in development.
- Click next to the widget and select Publish.
A Publish widget modal appears, where you'll be prompted to fill out information about your widget. 
- Use the first section to add a thumbnail for your widget. The thumbnail will appear in the Figma Community and in widget search results. To add a thumbnail:
- Select the widget object on your FigJam board and Copy as PNG.
- Mac: ⇧ Shift ⌘ Command C
- Windows: Control C
- Right-click widget > Copy as PNG
- Select the thumbnail area and paste.
- Mac: ⌘ Command V
- Windows: Control V
- Upload assets and complete the information for Icon, Name, Description, cover art, tags, support contact.
- Use the Creators field to add any other contributors to the widget. They will need to have an existing Figma Community profile. Type a person's name or handle in the field to search for their profile, and click to select. They’ll need to accept the invitation for their name to be displayed on the resource page.
- Choose whether fellow Figma Community members can comment on your widgets. Comments in the Community are turned on by default, but you can turn off community comments at any time.
- Click Publish to submit your widget for review.
Publish an update
Publish updates to your widget if you've made changes to the code or fixed a bug. You can also edit the details of your widget page at any time without publishing a new update. Learn how publish updates to your widget →
Share your widget
Published widgets have their own listing in the Figma Community, which allows other Figma users to find and install them.
Every widget has a unique URL that you can copy and share with others. Find the widget URL in the Share section of a widget listing. It will look something like this: https://www.figma.com/community/widget/uniqueidentifier
If you have more than one widget, you may want to share your creator profile instead. Learn more about Community profiles →
Congratulations, you've published a widget! Next, learn how to manage widgets as a developer.