Manage widgets as a developer
Before you start
Who can use this feature
Supported on any team or plan
You must use the Figma desktop app to create and publish widgets. The Figma desktop app is only available for Mac and Windows. Download the Figma desktop app →
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 →
- Manage widgets as a developer (Current article)
Update a widget
Publish a new release
Only the original widget publisher can publish updates to a widget. You can still list other contributors to the widget as creators, but they won't be able to publish any changes.
Once Figma approves your widget, you no longer need to submit your widget for further review. This means you can publish any updates immediately.
When you publish an update, Figma will update the widget for every user. Users who have already installed your widget will only have access to the latest version of your widget.
It's not possible for users to revert to a previous version of the widget. If you need to roll back any changes, you can republish an earlier version of the widget.
The process for submitting an update is the same as the original publishing process. You can update any information about your widget, including the name, description, tags, creators, and any artwork.
- Open a Figma Design or FigJam file on the Figma desktop app.
- Click the Figma logo in the upper-left corner, then go to Widgets > Manage widgets.
- Click next to the widget and select Publish new release.
- Use the Publish modal to update widget information as needed.
- Use the toggle in the Update section to publish a new version and increment the version number, or stay with the current one. Keeping the current version is useful when no code changes were made and only the resource’s metadata is being updated.
- Use the Version notes field to include any changes you've made or bugs you're addressing with this version.
- Update the security self-assessment form on the Data security tab. If you've previously submitted the self-assessment and the form has not yet been approved, a banner appears in the form to identify that the widget is still under review.
- Update any other fields as needed.
- Click Publish new version to complete the process. Figma will update the widget for everyone that has it installed.
Edit widget page
A widget page helps users understand what your widget does and allows them to install it for use. Creators, contributors, and publishers of a widget can edit the details of the widget's page at any time without having to publish an update.
Note: You currently cannot modify images and video uploaded to the media carousel on the widget's Community page using this setting. To do so, you must publish a new release of the widget from the editor.
- Open the widget's page.
- Click Edit this page in the right-hand column.
- An Update widget modal will appear. Update the desired fields, and click Save changes when you're finished.
Manage permissions
Invite additional publishers
Once your widget is published to the Figma Community, you can invite others to help publish updates to your widget. Learn how to invite additional publishers →
Transfer ownership of private organization widgets
Owners of private organization widgets transfer ownership to any one who has permission to publish a resource. Organization admins can also transfer ownership of private widgets to another organization member.
Note: You cannot transfer ownership of widgets published outside of an organization.
- Open a Figma Design or FigJam file on the Figma desktop app.
- Open the permissions modal:
- Click and select the Widgets tab.
- Open the dropdown menu and select Development.
- Click next to your widget and select Manage permissions.
- Click the dropdown next to a publisher’s name.
- Select Owner. The former owner will have their permissions changed to Can update.
Remove a widget
If you're a developer of a widget, you can remove a widget at any stage of the development process.
Published
If your widget is published to the Figma Community, unpublishing your widget will remove it for anyone who has installed it. Users who've installed your widget won't receive a notification if it's been unpublished.
Note: Paid widgets cannot be unpublished but can be delisted. Learn more about delisted paid resources →
We recommend warning your users of your plans to unpublish the widget. For example, you can add a note to the widget description or your personal website with the date you will upublish the widget.
- Open a Figma Design or FigJam file on the Figma desktop app.
- Click the Figma logo in the upper-left corner, then go to Widgets > Manage widgets.
- Click next to the widget you want to unpublish and select Unpublish from the options.
The widget will be removed from the Figma Community and users will no longer be able to use the widget or view the listing. The widget will remain in development on your account.
When removing a widget from the Community, likes and installs will be retained, but any details—such as title, tagline, description, and so on—will be lost.
In development
If you decide to cease development of a widget, or want to start from scratch, you can remove the widget. This will delete the widget from Figma, but you can still access the manifest from your computer.
- Open a Figma Design or FigJam file on the Figma desktop app.
- Click the Figma logo in the upper-left corner, then go to Widgets > Manage widgets.
- Click next to the widget you want to remove and select Remove from the options.
It's not possible to restore a deleted widget. Deleting a widget will also remove any likes and installs you have acquired, even if you publish the same widget in the future.
Provide support
Figma does not provide support for third-party applications. As the widget's developer, it's your responsibility to assist your widget users with technical issues.
You need to add a Support contact when you submit your widget for approval. This can be an email address users can contact or a link to a website or help center.