diff --git a/src/resources/schema/definitions.yml b/src/resources/schema/definitions.yml
index 6aa7c641924..79386d8d877 100644
--- a/src/resources/schema/definitions.yml
+++ b/src/resources/schema/definitions.yml
@@ -2958,7 +2958,8 @@
                     #     string:
                     #       pattern: '^U\+[0-9A-F]{4}(?:-[0-9A-F]{4})?(?:,U\+[0-9A-F]{4}(?:-[0-9A-F]{4})?)*$'
         description: >
-          The font files to include. These can be local or online.
+          The font files to include as an array (`- path: <path>` or `- <path>`).
+          These can be local or online.
           Local file paths should be relative to the `brand.yml` file.
           Online paths should be complete URLs.
     required: [files, family, source]
diff --git a/src/resources/types/schema-types.ts b/src/resources/types/schema-types.ts
index 0b71fd55794..865d34ee818 100644
--- a/src/resources/types/schema-types.ts
+++ b/src/resources/types/schema-types.ts
@@ -1470,7 +1470,7 @@ export type BrandFontFile = {
     path: string;
     style?: BrandFontStyle;
     weight?: BrandFontWeight;
-  }))[] /* The font files to include. These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs. */;
+  }))[] /* The font files to include as an array (`- path: <path>` or `- <path>`). These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs. */;
   source: "file";
 }; /* A method for providing font files directly, either locally or from an online location. */