From 28d69d9a94c13b2b39e99d207c2ee595b59781c9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Miguel=20=C3=81ngel?= Date: Wed, 11 Nov 2026 03:19:28 +0000 Subject: [PATCH] docs(variables): say what can be a variable, including a video or sound per account (#7530) * docs(variables): say what can be a variable, including a video or sound per account * docs(variables): render the per-account example from index.html and keep the outline --- docs/concepts/variables.mdx | 71 ++++++++++++++++++++++++++++++------- 1 file changed, 59 insertions(+), 12 deletions(-) diff --git a/docs/concepts/variables.mdx b/docs/concepts/variables.mdx index bc058cff21..81e3ffb923 100644 --- a/docs/concepts/variables.mdx +++ b/docs/concepts/variables.mdx @@ -60,20 +60,23 @@ Variables live on the composition declaration: > ``` -Supported declared types are: +### What can be a variable -| Type | Good for | -| --------- | -------------------------------------- | -| `string` | Text or a media path | -| `number` | Counts, positions, sizes, or strengths | -| `color` | Approved color choices | -| `boolean` | On or off | -| `enum` | One value from an approved list | -| `font` | A font-family choice | -| `image` | An image path or image value | +A variable has one of seven kinds. The kind sets the control the browser editor +shows and what a render accepts for it. -The type lets the browser editor show the right control and lets rendering catch invalid -values. +| Kind | What it holds | Example | +| --------- | ---------------------------------------------- | -------------------------------- | +| `string` | Text, or a link to a file | A customer name, a video link | +| `number` | A count, position, size, or strength | Seats on a plan, a speed | +| `color` | One approved color | A brand accent | +| `boolean` | On or off | Show the badge | +| `enum` | One value from a list you approved | `light` or `dark` | +| `font` | A font family | The headline typeface | +| `image` | A link to a picture | A customer logo | + +Video and sound have no kind of their own. Declare the link as a `string`, then +bind it to a `