Last updated
Was this helpful?
Last updated
Was this helpful?
Text Case Tokens define a transformation to the capitalization of letters as an individual property to be composed within a . It is not intended to be applied to text elements directly.
Text Case defines that the system should transform the capitalization of letters in a text element regardless of how they are typed.
Text Case design decisions are typically used to:
communicate the visual emphasis of text or
standardize data inputs and data display to ensure consistency
Occasionally, they are used for creative styling decisions, for example, a personal blog where the author wants:
HEADINGS to have all letters capitalized.
contact details to appear in lowercase.
When we apply a Typography Composite Token to a text layer in Figma, these Text Case values will change the letter casing:
All letters appear as typed - null
By default, the system will not transform the capitalization of letters
All letters capitalized - uppercase
Examples:
button labels
list of countries presented as abbreviations
No letters are capitalized - lowercase
Examples:
email address listed in a contact section
username entered in a sign-up form
The first letter of each word is capitalized - capitalize
Examples:
full name entered in a sign-up form
list of city names
The syntax used to write string values for Design Tokens is important, so be sure to write your Text Case Token value with all lowercase letters and ensure there are no spaces.
The Text Case Token has a few specific string Values depending on your needs.
null
Most of the time, text will appear as typed; the Text Case Token Value will be:
uppercase
When all letters should be capitalized, set the Text Case Token Value to:
lowercase
When none of the letters should be capitalized, set the Text Case Token Value to:
capitalize
When the first letter of each word should be capitalized, set the Text Case Token Value to:
Many people confuse Figma's "capitalize" with "title case," but they are different.
Title case has some words capitalized while others remain lowercase.
For example Hyma for Tokens Studio
Capitalize transforms all words.
For example Hyma For Tokens Studio
Not supported by Figma
Additional text-transform properties commonly used in CSS are not supported in Figma, such as Full Width.
You can still create Text Case Tokens with these Values using the Tokens Studio plugin.
When you apply them to design elements in Figma, the Token will be present and visible to engineers inspecting the design element in Figma, but the Token won't interact with the Letter Case property in Figma's UI.
When trying to reference another Token as the Value for a Text Case Token, you will see Tokens in the dropdown list that are:
Living in Token Sets that are currently active.
In the left menu on the plugin's Tokens page, a checkmark is visible next to the Token Set name.
Token Type is compatible:
The same = textCase
Text Case is not yet an official Token type in the W3C Design Token Community Group specifications.
Tokens Studio has added Text Case as an unofficial Token Type in anticipation of its inclusion in the W3C specs in the near future.
When transforming Test Case tokens, there are no specific transforms to be aware of.
Running the SD-Transforms pre-processor as part of the generic package will prep your Text Case Tokens for Style Dictionary.
However, Text Case, as part of Typography Composite Tokens, requires the SD-Transforms option to expand composite Tokens into multiple Tokens.
Mentioned in this doc:
None yet!
None yet
None
In , this property is called text-transform.
→
SD-Transforms -
Style Dictionary -
Design Tokens Community Group -
Design Tokens Community Group -
Design in Figma -
MDN Web Docs -
Tokens Studio Plugin GitHub -
🐞 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
💌 Visit to contribute or subscribe to updates.
💡 Something to share?
However, like all Token Types, you can "force" a reference by manually entering the Token Name between curly brackets.
For example {token.name.here}
Jump to the guide on Token Values with References by selecting the card below to learn more.
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.
Make sure you look at the generic SD-Transforms package to include this option, which allows you to further customize this transformation further using Style Dictionary.
→