SiteBranding

SiteBranding

Documentation

Site browser/install presentation and publisher logo assets. Branding files are authored as site assets and referenced here by their public paths. Best practice is to place root-level browser assets such as favicons, touch icons, and the web app manifest in the site's assets directory. Quail Pages copies site assets into the generated site while preserving their public paths, allowing files intended for the web root to be referenced from paths such as /favicon.svg or /site.webmanifest.

Kind

Site Configuration

Required fields

None

Used by

Authoring guidance

Use when

Use for site-wide logo assets, favicons, installed-app metadata, and browser presentation.

Properties

appleTouchIcon

string

Apple touch-icon path.

Recommended: Supply an Apple touch icon for saved sites on Apple devices.

appTitle

string

Installed-app title.

Recommended: Supply an app title for installed and saved site experiences.

faviconIco

string

ICO favicon path.

Recommended: Supply an ICO favicon for broad browser compatibility.

faviconSvg

string

SVG favicon path.

Recommended: Supply an SVG favicon for modern browsers and high-resolution displays.

manifest

string

Web app manifest path.

Recommended: Supply a web app manifest for complete browser and installed-app metadata.

publisherLogo

string

Publisher image included in Organization and legacy Article JSON-LD.

Recommended: Supply a publisher logo for complete article structured data.

themeColor

string

Browser and app theme color.

Recommended: Supply a theme color consistent with the site's visual identity.

Example

Required

{}

Full

{ "appleTouchIcon": "example", "appTitle": "example", "faviconIco": "example", "faviconSvg": "example", "manifest": "/site.webmanifest", "publisherLogo": "example", "themeColor": "#0f172a" }

examples are generated from the schema.