Tokens Studio for Figma
  • Getting Started
    • Tokens Studio Plugin for Figma
    • Install the Figma Plugin
    • Pro Licence for the Figma Plugin
    • Join the Slack Community
    • Feature Requests - Featurebase
    • Changelog - Featurebase
  • Design Token Fundamentals
    • Intro to Design Tokens
      • Token Anatomy - Type
      • Token Anatomy - Value
      • Token Anatomy - Description
      • Token Anatomy - Name
  • Token Management
    • Token Types
      • Asset
      • Boolean
      • Border - Composite
      • Box Shadow - Composite
      • Color
        • Modified Colors (pro)
        • Gradient Colors
      • Dimension
        • Border Radius
        • Border Width
        • Sizing
        • Spacing
      • Number
      • Opacity
      • Other
      • Text (string)
      • Typography - Composite
        • Font Family
        • Font Weight
        • Font Fallbacks
        • Font Size
        • Line Height
        • Letter Spacing
        • Paragraph Indent
        • Paragraph Spacing
        • Text Case
        • Text Decoration
      • Composition (legacy)
    • Token Values
      • Token Values with References
      • Using Math in Token Values
    • Token Names
      • Token Name Technical Specs
      • Token Groups
      • Edit Token Names
    • Token Description
    • Token Sets
      • JSON View
  • Themes management
    • Themes (pro)
    • Themes that switch
  • Working in Figma
    • Variables and Tokens Studio
    • Styles and Tokens Studio
    • Export to Figma Guide
      • Export Options
      • Export Using Themes (pro)
      • Export Using Token Sets
      • Variables Skipped on Export
      • Styles with Variable References
    • Import from Figma Guide
      • Import Styles from Figma
      • Import Variables from Figma
        • Connect Themes to Imported Variables
        • Imported Variable Types and Token Types
    • Non-local Variables and Styles (pro)
    • Remove Tokens from Figma elements
    • Dev Mode in Figma
  • Settings Management
    • Plugin Settings
    • Base Font Size Setting
    • Token Format - W3C DTCG vs Legacy
  • Token Storage and Sync Integrations
    • Local Document - Figma File Token Storage
      • Figma Data Limits
    • Remote Token Storage Integrations
      • GitHub - Git Sync Provider
      • GitLab - Git Sync Provider
      • Bitbucket - Git Sync Provider
      • Azure DevOps - Git Sync Provider
      • JSONBin - Cloud Sync Provider
      • Supernova - Cloud Sync Provider
      • Tokens Studio Platform - Cloud Sync Provider
      • URL - Server Sync Provider
      • Generic Versioned Storage - Server Sync Provider
    • Multi-file Sync to Remote Storage (pro)
    • Manage Sync Providers
      • Edit Sync Provider
      • Change Active Sync Provider
      • Remove Sync Provider
    • Sync Changes to Remote Storage - Push and Pull
    • Branch Switching (pro) - Version Control
  • Inspect and Debug Tokens
    • Inspect Tokens
    • Remap Tokens
  • Transform Tokens for Development
    • Style Dictionary + SD Transforms
    • Official docs for Style Dictionary
  • Style Dictionary Playground
  • Troubleshooting
    • Reset Tokens from Dev Console
    • Tokens Studio Status
  • Open Source
    • Contribute
    • Shared Plugin Data
Powered by GitBook
On this page
  • Token Types in Tokens Studio
  • Common Terms
  • Working with Token Types
  • Transforming Tokens
  • Available Token Types
  • Resources

Was this helpful?

Edit on GitHub
Export as PDF
PreviousToken Anatomy - NameNextAsset

Last updated 4 months ago

Was this helpful?

Token Types in Tokens Studio

The type is the anatomic part of a Design Token that defines the category of design property the decision belongs to, or when it can be applied.

You might recall from our that the type determines what Values are acceptable.

Tokens Studio (TS) supports 24 unique Token Types.


Common Terms

These terms are not the only way to describe Token Types; they are the labels the Tokens Studio team uses for simplicity across our documentation.

If your team uses different descriptive terms, that's totally okay!

Official

For example, Dimension Token is an official type.

Unofficial

Unofficial Token Types were created by Tokens Studio before the W3C DTCG Specs defined an alternate Token Type.

For example, Border Width Token is an unofficial type defined by the spec as a Dimension Token.

Any Token Types we are planning to deprecate will be listed as legacy.

Composite

When elements are styled by composing many related design decisions together, they are combined into a Composite Token Type.

For example, a Typography Token is composed of 9 independent text-related properties.

Property

Each design decision that is a part of the Composite Token is referred to as a property of their respective Composite Token in our guides.

For example, fontFamily and fontWeightare unofficial Tokens we created to independently define the properties that Compose a typography Token.

They may be included in the DTCG Specifications in the future, in which case they would be official property Tokens.

Compatible

A Token Type with properties that is compatible with another Token Type.

For example, the dimension Token Type is compatible with fontSize when referenced within a typography Composite Token.

Compatible Token Types are visible by default when defining Token Values which reference another Token in the plugin. This becomes important when creating and maintaining Tokens in the plugin.


Working with Token Types

In the Plugin, you select which Type of Token you'd like to create using a no-code interface. Under the hood, Tokens Studio will write the Token as properly formatted JSON files so they can be used in code.

You might recall that Design Tokens are platform agnostic, written in a common language so they can shared across different tools and technologies.

This means that engineers working with Design Tokens have to transform them from JSON files into whatever specific programming needs they have before they can work with them.

Transforming Tokens

Some Tokens we create in Tokens Studio (TS) have subtle differences in how the Token type is written compared to the DTCG specifications. In the case of unofficial Token Types, which don't exist in the DTCG spec, we have to transform the TS Type into something Style Dictionary is prepared to work with.

The SD-Transforms package's preprocessor will transform the TS Token Type to the Style Dictionary Type, as described in the table below.


Available Token Types

Each Token Type has unique properties and specifications, which are documented in detail. Select the common name of the Token Type in the table below to access its docs.

Common Name
W3C DTCG Official
Composite
TS JSON Type
SD Type
DTCG Type

✓

Can be a Property of border, shadow

color

color

color

✓

Composite

typography

typography

typography

✓

Property of typography

fontFamilies and fontFamily

fontFamily

fontFamily

✓

Property of typography

fontWeights and fontWeight

fontWeight

fontWeight

✓

Property of typography

fontSizes and fontSize

fontSize

fontSize

✓

Property of typography

lineHeights and lineHeight

lineHeight

NA

✓

Property of typography

letterSpacing

dimension

dimension

X

Property of typography (in TS, not DTCG)

paragraphSpacing

dimension

dimension

X

Property of typography (in TS, not DTCG)

textCase

textCase

NA

X

Property of typography (in TS, not DTCG)

textDecoration

textDecoration

NA

✓

Can be a Property of border, shadow, typography

dimension

dimension

dimension

✓

number

number

number

✓

Composite

border

border

border

✓

Composite

boxShadow

shadow

shadow

X

borderRadius

dimension

dimension

X

borderWidth

dimension

dimension

X

spacing

dimension

dimension

X

sizing

dimension

dimension

X

asset

asset

NA

X

boolean

boolean

NA

X

text

content

NA

X

other

other

NA

X

opacity

opacity

NA

X

composition

each type in the composition is added individually

NA


Resources

Mentioned in this doc:

Community resources:

  • None yet!

Known issues and bugs

Requests, roadmap and changelog

Before you jump into the technical docs for each Token Type, you may want to review the that will help strengthen your knowledge.

Official Token Types are listed in the

Tokens Studio will continue to support unofficial Token Types for now. We've already built a conversion into our SD-transforms script; .

→

SD-Transforms -

Style Dictionary -

Design Tokens Community Group -

Design Tokens Community Group -

Tokens Studio Plugin GitHub -

Tokens Studio Plugin GitHub -

Remove composition tokens

Expand Token Types -

W3C Design Tokens Community Group (DTCG) Specifications for Design Tokens
SD-Transforms Read-Me Doc, Using the preprocessor
Read Me
https://styledictionary.com/
W3C Draft
8.0 Token Types
Open issues for Transforming Token Types
Open issues for Token Type Support
#2800
Feature request
common terms and concepts below
more details are below ↓
Color Token
Typography Token
Font Family Token
Font Weight Token
Font Size Token
Line Height Token
Letter Spacing Token
Paragraph Spacing Token
Text Case Token
Text Decoration Token
Dimension Token
Number Token
Border Token
Box Shadow Token
Border Radius Token
Border Width Token
Spacing Token
Sizing Token
Asset Token
Boolean Token
Text Token
Other Token
Opacity Token
Composition Token
Intro to Design Tokens Guide

🐞 If you are experiencing an issue not listed here, please reach out to us on the Troubleshooting channel of our , , or send us an email support@tokens.studio

💡 Something to share?

community Slack
submit it on our feedback tool
Submit it here!
Page cover image
In this infographic, the Token examples on the right side highlight the Type. Both code blocks have coloras the Token Type.
Cover

Color

Layer fill and stroke.

Cover

Opacity

Defines layer transparency.

Cover

Box Shadow - Composite

X, Y, Blur, Spread, and Color.

Cover

Border - Composite

Stroke color, width and style.

Cover

Asset

URL hosted images and assets.

Cover

Boolean

Controls layer visibility.

Cover

Border Width

Unofficial Token converted to a Dimension Token.

Cover

Sizing

Unofficial Token converted to a Dimension Token.

Cover

Spacing

Unofficial Token converted to a Dimension Token.

Cover

Number

Unitless numeric value.

Cover

Dimension

Numeric value with pixel or rem units.

Cover

Border Radius

Unofficial Token converted to a Dimension Token.

Cover

Text (string)

Strings of text for copy and content.

Cover

Typography (composite)

All text and font styling properties combined.

Cover

Font Size

Define in pixel or rem values for responsive design.

Cover

Font Family

Works with Font Weight as a pair in Figma.

Cover

Font Weight

Works with Font Family as a pair in Figma.

Cover

Line Height

Define in percentage for responsive design in Figma.

Cover

Letter Spacing

Define in percentage for responsive design in Figma.

Cover

Paragraph Spacing

Matches Figma's text property.

Cover

Paragraph Indent

Defined as a Dimension Token.

Cover

Text Decoration

Define underline or strike for additional emphasis.

Cover

Text Case

Define caps or title case to change text.

The Tokens page of the Tokens Studio Plugin shows all Token Types supported. The list is quite long, so the page is scrolled and shown side-by-side to capture them all.
The Geko in this infographic represents Style Dictionary.

💌 Visit to contribute or subscribe to updates.

https://feedback.tokens.studio/

Select the Token Type card below to jump to its guide.

→ Read the Token Values with References guide for more details

Token Values with References

Engineers typically transform Tokens used in code with , which is tool-agnostic. Tokens coming from Tokens Studio require an additional step: , an npm package that prepares Tokens for Style Dictionary.

Style Dictionary
@Tokens-studio/sd-transforms