Manage design tokens

Brienne Wong
Brienne Wong
  • Updated

This is currently in open beta and available for all plans. This will not be available for legacy plans.

You can manage your tokens in zeroheight with Token Manager. This will enable you to centralize and manage design decisions directly in your documentation. You can only import a JSON file as the basis for tokens. For best results, we recommend following the W3C Design Tokens specification.

Manage tokens

You can manage your tokens in the Tokens section of your account.

Tokens section in zeroheight

Create a token set

From GitHub

 👉 Note: You can only import one file from one repo at a time.

2) In the Tokens section, click Create token set

Create token set function in the Tokens section

2) Enter Token set name and select Create

Enter token set name in field

3) Select GitHub as the token source

Window to pick between GitHub and JSON as token source

4) Connect to your GitHub account

5) Select the token set from the code repo you want to upload from and click Continue

Pick repo from GitHub

5) Click Finish

Window for importing tokens

6) You’ve created a token set from GitHub.

Tokens imported from GitHub now in zeroheight

7)You can:

  • import changes from GitHub into zeroheight
  • make changes to your token set in zeroheight and push those changes back into GitHub
  • publish changes to the tokens you’ve added in your styleguide
  • export your file as a JSON

Push changes function to create pull requests from GitHub

From a JSON file

Note: You can only import one file from one repo at a time.

1) In the Tokens section, click Create token set

Create token set function in the Tokens section

2) Enter Token set name and select Create

Enter token set name in field

3) Select JSON import as the token source

Window to pick between GitHub and JSON as token source

4) Upload JSON file and select Continue

JSON file to be uploaded in zeroheight

5) Select Finish

Window for importing tokens

6) You’ve added your token set as a JSON file.

Tokens imported from JSON now in zeroheight

7) You can:

  • upload another JSON file

  • export your set as a JSON file

  • publish changes to the tokens you’ve added to your styleguide

Publish changes function to publish changes to your styleguide

Add and edit tokens

Once you’ve imported your tokens from GitHub or as a JSON file, you can create tokens directly in zeroheight.

1) In your file, select +Add Tokens

Red arrow pointing to Add tokens function

2) Enter the token name and value and select Create token

Window to create color token

3) You have a new token that you can add to your styleguide and your token file.

New token added to your token set

FAQs

What if I delete my token set?

Your tokens will still be in your styleguide even if you delete your token set from the Tokens tab; however, the link to your token set in GitHub is disconnected. If you want to update your tokens in your styleguide, you must delete them and reinsert them.

Can I use the Tokens Studio (aka Figma Tokens) plugin with the tokens manager?

We don’t support the Tokens Studio export format right now, but we are investigating how to support this in the future. Read more about how to convert your design tokens to the W3C Design Tokens spec.

What tokens format does zeroheight support?

We only support JSON files as the basis for tokens at this time. For best results, we recommend following the W3C Design Tokens specification.

The W3C format we've adopted is intended to be a cross-platform / cross-tool standard, which means tokens aren't locked to a single tool. Other popular tools have also made commitments to adopt this format.

Read more about how to convert your design tokens to the W3C Design Tokens spec.

Was this article helpful?