Manage branding assets

Upload reusable brand images and reference them safely from Design, brand.json, and styles.css

Use the asset library to keep reusable brand images with your platform account. Customer projects can't browse this library, and adding an item only makes it available to Branding; it does not publish Branding.

Availability

The library is available to platform account owners and admins in the Platform dashboard. It is account-scoped: assets and their references belong to the platform account, not to an individual customer project.

Upload assets

Use PNG, WebP, or JPEG files. Each input file can be up to 4 MB. You can review up to ten files in one batch; the account can hold 200 active assets and 250 MB of processed storage across asset versions.

In the Platform dashboard, select White-label > Branding > Assets.
Select Add files, or drop image files anywhere in the Assets tab. The review queue suggests a type from the image shape: wide images become Wordmarks, small square images become Icons, and large wide images become Backgrounds. Select another type if the suggestion is wrong.
Review one file at a time. Enter a clear Asset name. If needed, rotate the image, crop it, and choose Free, 1:1, 4:3, or 16:9 for the crop ratio.
Select Add and next to add the current file and continue reviewing, or Add to library when it is the only remaining file. Select Add all n to add every remaining reviewed file with its current edits. Select Skip this file to leave the current file out of the library.

Unsupported files, files over 4 MB, skipped files, and files rejected because a quota is full stay out of the library. Correct or remove the affected file, then retry the upload.

Use an asset

Use an asset from the Design editor or write its reference in brand.json or styles.css. The Assets dashboard's Copy reference action copies the first alias when one exists; otherwise it copies the asset UUID reference.

Use either canonical form:

assets.primary-wordmark
assets.2f4d2f74-2ec0-4fa0-a5ad-7995f64612b9

assets.primary-wordmark uses an alias: a readable, stable name for the asset. The UUID form always identifies that asset, even if it has no alias. A published release pins the exact asset version it used, so later changes cannot alter the files in that release.

When you select an asset in the editor, it inserts the same reference in the appropriate format:

"assets.primary-wordmark"

url("assets.primary-wordmark")

asset:// is a legacy spelling that existing saved branding can still read. Use assets. for all new work.

Manage names and aliases

Use Search assets and the Asset type filter to find an item. The type filter can include Font family for accounts where that category is present; it does not provide a font upload or activation workflow.

Select Copy reference to copy a usable reference. Select Rename to change the library label, or manage aliases in the same dialog. Renaming the display name does not change references.

An alias contains 1–60 lowercase letters or digits, optionally separated by single hyphens. It cannot start or end with a hyphen, contain consecutive hyphens, or have a UUID-shaped value. Add an alias when you need another readable reference; remove one only after you have removed it from every saved and live Branding reference. The dashboard blocks removal while a reference remains.

Archive an asset

Select Archive on an asset that is no longer used. Archiving is blocked while the asset is referenced by a draft or release. Remove or replace those references first, then archive the asset.

Recover from asset errors

If the library fails to load, select Retry. An empty library and an unsuccessful search are different states: No assets yet means the account has no active assets, while No assets match these filters means the library has assets that do not match the current search or type filter.

If Branding reports an unresolved asset reference, the reference does not match an active asset in this account. Fix the reference or replace it with a valid one before you save or publish. If an alias cannot be removed or an asset cannot be archived, use the listed saved branding, drafts, or releases to find the remaining reference, remove or replace it, and try again.