Skip to content

Main content

Design Token Reference Label

Qualify a supplied design-token name by namespace and version without resolving token values.

Loading tool…

Description

Record a design token's explicit reference label.

Graphic-design metadata distinguishes font metrics, variable-font axes, fill rules, color labels and design-token units. Numeric axis differences and text labels do not render a font or apply a color profile. The source convention must match before comparing metrics or resolving a design-system reference.

Record a design token's explicit reference label.

When to use this tool

Use Design Token Reference Label when checking the stated font, color or design-token convention.

How to use the tool and how it works

  1. Enter namespace, tokenName, version. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read token. Use the output convention below.

Require nonempty namespace, tokenName and version. Encode [namespace,tokenName,version] as JSON text.1

Input fieldMeaning and unitsAccepted input
namespaceNamespaceRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
tokenNameToken NameRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
versionLiteral version text; no semantic ordering or current-version lookup.Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenJSON-encoded ordered tuple or literal token under the convention above; not a database lookup or authentication result.Required. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "namespace": "brand",
    "tokenName": "color.accent",
    "version": "v2"
  },
  "output": {
    "token": "[\"brand\",\"color.accent\",\"v2\"]"
  }
}

Limitations and assumptions

  • The token reference is recorded without resolving a design system, validating an edition or converting units.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.

Alternative or Complementary methods

Inspect actual fonts, rendered paths, color profiles and the complete applicable design-system specification for visual or production decisions.

References

  1. Calculation and input contract: graphic-design/design-token-reference-label — tool.io

Similar or alternative tools