diff --git a/docs/authoring/brand.qmd b/docs/authoring/brand.qmd
index b5755fd291..21a8310748 100644
--- a/docs/authoring/brand.qmd
+++ b/docs/authoring/brand.qmd
@@ -196,10 +196,11 @@ You can access both named and semantic colors from your brand in SCSS and using
 
 <https://posit-dev.github.io/brand-yml/brand/logo.html>
 
-Use `logo` to specify the logo for your brand: *This doesn't pass validation*
+Use `logo` to specify the logo for your brand:
 
 ``` {.yaml filename="_brand.yml"}
-logo: logo.png
+logo: 
+  medium: logo.png
 ```
 
 You can specify a local file path, relative to the location of `_brand.yml` or a URL (*is this true?*).
@@ -261,7 +262,7 @@ typography:
       source: google
 ```
 
-The properties you can set for a font under `fonts` depends on the `source`. You can see the other properties available in our [Reference for Brand](docs/reference/metadata/brand.qmd#font-resource-definitions)
+The properties you can set for a font under `fonts` depends on the `source`. You can see the other properties available in our [Reference for Brand](docs/reference/metadata/brand.qmd#font-resource-definitions).
 
 You can then refer to fonts by `family` in the remaining typography options:
 
@@ -444,6 +445,14 @@ $navbar-bg: $brand-blue;
 
 ### Typst
 
+Brand colors are available in `brand-color`:
+
+````markdown
+```{=typst}
+#set text(fill: brand-color.primary)
+```
+````
+
 ### Lua API
 
 ``` lua