Welcome to the FAQ for Design Tokens Export & Deploy (Figma & Penpot). Here you'll find answers to common questions to help you get started and troubleshoot issues efficiently.
How do I install the plugin?
Choose your platform:
- Figma: Go to the plugin page on Figma Community and click "Open in...". Then open a Figma file, go to Plugins > Figma CSS Variables: Design Tokens Export & Deploy. See Use plugins in files from Figma.
- Penpot: Coming soon. Once published, go to the plugin page on Penpot Plugin Hub and click Install. The plugin will appear in your Plugin Manager (
Ctrl + Alt + P). See Penpot plugins guide.
The plugin won't launch, what should I do?
Ensure your design tool is up to date and that the plugin is properly installed. Check your internet connection and look for any errors displayed in the tool. Additionally, try restarting both the tool and the plugin.
Check the browser's Developer Tools (right-click > Inspect > Console tab). If there are errors, share them on the GitHub Discussions with a reproduction scenario and captures of the error messages.
How do I subscribe?
Click the Subscribe button in the plugin (visible on the Deploy or Export tab when you're not subscribed). You'll be redirected to Stripe Checkout to complete the payment. After a successful payment, your access is updated automatically.
How do I manage or cancel my subscription?
Go to the Settings tab and click Manage subscription. You'll be redirected to Stripe Customer Portal where you can update your payment method, view invoices, or cancel your subscription.
What happens if my payment fails?
Stripe will retry the payment automatically. If the payment continues to fail, your subscription will be marked as inactive and Pro features will be locked. You can update your payment method through the Stripe Customer Portal (Settings > Manage subscription).
What features are included in the subscription?
See the Pro section on the Figma store page for the full list of features included with a subscription. Penpot version coming soon.
The Export tab (preview and copy to clipboard) remains free for all users.
Is my subscription tied to a specific platform account?
Yes. Your subscription is linked to the account you used when subscribing (your Figma or Penpot account depending on the platform you subscribed from). Make sure you're logged into the same account when using the plugin. If you use multiple accounts, you'll need a subscription for each one.
I had a license before. What do I need to do?
Nothing. Your license was automatically linked to your account. If your Pro status doesn't show as active, go to Settings > Refresh to force a status check.
How do I export my tokens?
Go to the Export tab, select a collection and mode, preview the output, then copy it to your clipboard.
Pro users: download all files as a ZIP.
Some design tokens aren't exporting properly. What's happening?
The plugin applies transformations to ensure valid output for each target language:
- Slashes (
/) and spaces are replaced with hyphens (-) in names. - Numeric values (FLOAT type) automatically append the
pxunit. - Design tokens are sorted alphabetically.
Can I export multiple collections at once?
The Download all option (Pro) exports all selected collections at once in a ZIP file. For the copy-to-clipboard option, only one mode of a collection is copied. The Git deployment feature (Pro) also lets you select specific collections and modes to deploy.
How do I enable Git deployment?
First, subscribe via the plugin (click Subscribe on the Deploy or Export tab). Once subscribed, go to the Settings tab to add a Git provider. Then go to the Deploy tab, select your provider, choose the collection modes to export, and click the Push button.
If the subscription status doesn't update immediately, click the Refresh button in the Settings tab.
I can't add a Git provider. What should I check?
Ensure your personal access token is valid and has the necessary permissions and the user/organization name, repository and branch are correct. For self-hosted GitLab, include the host URL (e.g., mycustomgitlab.com).
Check resources:
My push to Git fails. How can I fix it?
Troubleshoot with these steps:
- Check that the token has sufficient write permissions
- Verify the branch exists (the plugin will create it automatically if permissions allow)
- Ensure the repository URL and provider details are correct
- Confirm that the selected collections and modes are not empty
Can I push to specific branches?
Yes, you can specify the target branch in the provider settings. If the branch doesn't exist, the plugin will create it automatically.
Can I push to specific directories?
Yes, you can specify the base path in the provider settings. If the directories don't exist, the plugin will create them automatically.
Where are my Git provider details stored?
All Git provider data (token, owner, repository, etc.) is stored locally on your machine to ensure your privacy and security.
What data does the plugin send to your servers?
When checking subscription status, the plugin sends your user ID to verify your access. No email or personal information is sent.
I subscribed but the plugin still shows Inactive. What should I do?
First, make sure you're logged into the same account used for the subscription. Then go to the Settings tab and click the Refresh button to force a status check. If it still shows Inactive, try closing and reopening the plugin.
Activation is automatic and usually takes a few seconds. The Refresh button simply speeds up the process.
The deployment fails every time. What can I check?
Make sure:
- The token has the necessary permissions
- The target branch exists or that your token allows branch creation
- The selected collections and modes aren't empty
How do I report a bug or request a feature?
Use the GitHub Issues page for bug reports or feature requests. For general questions, join the GitHub Discussions.
How can I get support?
If your question isn't covered here, please post in our GitHub Discussions, and we'll help as soon as possible.