Publish widgets to the Figma Community

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:

1. Setup your development environment →
2. Create a widget for development →
3. Publish widgets to the Figma Community (Current article)
4. 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.

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.

About publishing paid widgets

If you’re an approved creator, you can publish your widgets as paid and sell them directly from the Community. Learn more about selling resources on the Community →

When publishing a paid widget, keep in mind:

• The creator who first publishes the widget will be the designated payee. Once the designated payee is set, it cannot be changed.
• You can customize a free trial period for paid widgets so users can try your widget before they purchase it. For more information see the Payments API documentation. 
• After a widget has been published as paid, it cannot be converted to free at a later date.
• Paid widgets cannot be unpublished but may be delisted. Learn more about delisted widgets →

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. 

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.

To publish a widget to the Figma Community:

1. Open a Figma design or FigJam file on the Figma desktop app.
2. Click in the top-left corner, then go to Widgets > Development > Manage widgets in development.
3. Click next to the widget and select Publish.

A Publish modal appears, where you fill out information about your widget.

1. 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:
   1. 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
   2. Select the thumbnail area and paste.
      • Mac: ⌘ Command V
      • Windows: Control V 
2. Upload assets and complete the information for Icon, Name, Description, cover art, tags, support contact.
3. If you are approved to sell on the Community and have activated your Stripe account, you can enable the Pricing toggle to configure a price for the widget. Keep in mind:
   • Widgets can be sold as one-time payments with a minimum price of $2.00.
   • Prices are in USD and must be whole numbers.
   • You can change the price at any time.

4. 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.
5. (Optional) Complete the security self-assessment form for your widget. The security self-assessment is a set of questions to help identify the data security practices of your widget. Your answers are reviewed by Figma.

   Note: When the self-assessment is approved by Figma, your answers are visible to any user who views the widget's listing in the Figma Community.

   To complete the security self-assessment form, at the top of the Publish widget modal, click the Data security tab. The assessment questions appear in the modal.
   

6. Check your widget's network access. To see the scope of network access that your widget has, go to Advanced > Widget Info.
   Your widget's network access is indicated by one of the following labels:

   • Unknown network access: Network access isn’t defined in your widget's manifest.json.
   • Unrestricted network access: Your widget can access any domain.
   • Restricted network access: Your widget can access only a specific set of domains.
   • No access to network: Your widget cannot access any domains.

   Click the label to get additional details.
   
   If there are errors in your manifest.json, the errors are identified. Correct the errors before publishing your widget.
   
   If your widget is labeled Unknown network access, you can specify network access in your plugin manifest to change the label.

7. 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.
8. 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.