Manage widgets as a developer

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 →
4. Manage widgets as a developer (Current article)

Update a widget

Publish a new release

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.

1. Open a Figma Design or FigJam file on the Figma desktop app.
2. Click the Figma logo in the upper-left corner, then go to Widgets > Manage widgets.
3. Click next to the widget and select Publish new release.
4. 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.
5. 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. 

1. Open the widget's page.
2. Click Edit this page in the right-hand column.
3. 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.

1. Open a Figma Design or FigJam file on the Figma desktop app.
2. Open the permissions modal:
   1. Click and select the Widgets tab.
   2. Open the dropdown menu and select Development.
   3. Click next to your widget and select Manage permissions.
3. Click the dropdown next to a publisher’s name.
4. 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.

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.

1. Open a Figma Design or FigJam file on the Figma desktop app.
2. Click the Figma logo in the upper-left corner, then go to Widgets > Manage widgets.
3. 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.

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.

1. Open a Figma Design or FigJam file on the Figma desktop app.
2. Click the Figma logo in the upper-left corner, then go to Widgets > Manage widgets.
3. Click next to the widget you want to remove and select Remove from the options.

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.