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
Creators and contributors
For security reasons, it's only possible for one developer to be involved in publishing a widget. This includes any updates to the widget.
The publisher 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.
- Create an icon to represent your widget in the Community. Figma will use this icon to identify your widget in the Community and in the Editor. The recommended dimensions are 128 x 128.
- Create some cover art for the top of your widget listing. The recommended dimensions are 1920 x 960 (safe area: 1600 x 960).
- 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 a 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.
Figma design
- Open a Figma file on the Figma desktop app.
- Click and select the Widgets tab. If you have a widget in development, you’ll be able to see the Development section in the dropdown menu.
- Click next to the widget and select Publish.
FigJam
- Open a FigJam file on the Figma desktop app.
- Click and select the Widgets tab. If you have a widget in development, you'll be able to see the Development section.
- 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.
- macOS: ⇧ Shift ⌘ Command C
- Windows: Control C
- Right-click widget > Copy as PNG
- Select the thumbnail area and paste.
- macOS: ⌘ 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.
- Add any Version notes.
- 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.
Widgets 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.
Share a 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.