Playground files for widgets and plugins
If you're using UI3, Figma's new design, some parts of this article might not match what you see in the product today. We appreciate your patience while we make updates. Learn more about Figma’s redesign →
Before you start
Who can use this feature
Supported on any team or plan.
Any publisher for a widget or plugin can upload a playground file to the resource.
Publishers can upload any Figma Design or FigJam file they have can edit access to.
Playground files are Figma Design or FigJam files that supplement plugins and widgets to show when and how to use the plugin or widget. They are especially helpful for showing how plugins or widgets are used on specific layers.
For example, a spell check plugin might include a playground file with misspelled text. A user can duplicate the playground file and try the plugin on the misspelled text.
You can access a resource's playground file by clicking the Try it out button from the resource's page in the Figma Community. The playground file is duplicated and saved to their drafts folder.
Add a playground file
To include a playground file with your plugin or widget, you'll need to go through the plugin's or widget's publishing process.
Any Figma Design or FigJam file you have can edit access to can but used as a playground file, and do not need to be published to the Figma Community.
Once a resource is published, the playground file won't appear as a resource on the publisher's profile.
Note: If you insert the development version of a widget into your playground file, only publishers of the widget will be able to run it.
Update a playground file
If you’ve updated your playground file and need the update reflected in the associated plugin:
- Open a Figma Design or FigJam file on the Figma desktop app.
- Open the publishing modal:
- Click and select the Plugins or Widgets tab.
- Open the dropdown menu and select Development.
- Click next to your plugin or widget and select Publish.
- From the publishing modal, hover over the playground file section and click .
- Click Update to latest version.
Try out a playground file
- Open a plugin's or widget's page.
- Click Try it out.
If a playground file is available, it’ll be duplicated and opened from your draft folder.