String

A reusable piece of text, such as a text case or a font face name. String is a Syntope extension, not a DTCG type: DTCG 2025.10 has no string token.

Partial: a string token cannot be applied to layers or mapped to a Figma variable. Its use is limited to the fields listed below.

Value format

{ "$type": "string", "$value": "UPPER" }

$value is one string, which may be empty, or one whole {curly} reference to another string token. Each string token must declare $type itself. A $type inherited from a group is refused.

In a file, string tokens sit in the root $extensions of their token set, keyed by dot path, so the file stays valid DTCG. The JSON editor shows this form:

{
  "$extensions": {
    "eu.syntope.stringTokens": {
      "text.case.action": { "$type": "string", "$value": "UPPER" }
    }
  }
}

A tool that does not read this extension ignores these tokens. Syntope Engine moves them back to their paths when it reads the file. A file with "$type": "string" in the token tree itself is refused, and so is a path that collides with another token or group.

In Syntope Tokens

In the type menu, choose text under Syntope types. The field takes text or a reference to another string token. Text is stored exactly as typed.

A Tokens Studio import creates string tokens for text tokens, text case, text decoration, named font weights and percentage letter spacing.

Where a string token can be used

• In another string token.
• In the text decoration, text case and font style fields of a typography token.
• In the letterSpacing key under eu.syntope.figma, for a percentage such as -2%. Write this one in the JSON editor.

A standard DTCG field, such as fontFamily in a typography value, cannot refer to a string token. The engine refuses this because another tool could not follow the reference. Use a token of the matching DTCG type there.

Like any token, a string token can differ between themes.

In Figma

Apply token is disabled for this type. Apply a typography token that refers to the string instead.

Variable sync leaves string tokens out with the reason “Syntope Tokens does not sync string tokens to Figma variables yet, so this token was skipped”.