Skip to main content AWT

Header brand

Your site name, with an optional logo and prefix, linked to your home page.

Live example

These are real Header brand blocks rendering on this page right now. Tab to them and try them in both color schemes.

AWT

Dark mode you don’t have to build

Every block supports dark mode. Use the light/dark toggle in the header and the live example above switches with it.

Parameters

Everything the Header brand block accepts. Setting is the label you see in the block’s settings panel. Parameter is what the same value is called in code. Accepts is what you can put in it.

Header brand block parameters
SettingParameterTypeDefaultAcceptsWhat it does
Brand modekindstringemptytext-only, text-with-prefix, logo-only, logo-with-text, logo-with-text-and-prefixWhat the brand shows: your site name, an optional prefix, a logo, or combinations.
Prefix (e.g., “IBM”)prefixstringemptyAny textSmall text before the site name, the way IBM shows “IBM” before a product name.
Site title overridesiteTitlestringemptyAny textOverrides the site name. Leave empty to use your WordPress site title.
Upload logologoUrlstringemptyA URLThe logo image for the light scheme.
Code onlylogoUrlDarkstringemptyA URLThe logo image for the dark scheme. Leave it empty to use the dark logo from AWT Settings.
Logo alt textlogoAltstringemptyAny textThe logo’s alt text. Required when a logo is set.
Link targethrefstring“/”A URLWhere the brand links. Defaults to your home page.

Accessibility parameters, on this and every AWT block

Every AWT block has an Accessibility panel in its settings. Each control in it becomes a real HTML attribute on the block’s outer element:

Accessibility parameters shared by every AWT block
SettingParameterWhat it does
Accessible name (aria-label)ariaLabelBecomes aria-label on the block’s outer element. Replaces the accessible name screen readers announce. Set it only when the visible label is not enough.
Described by (aria-describedby)ariaDescribedbyBecomes aria-describedby. Point it at the ID of another element on the page whose text adds a longer description.
Labelled by (aria-labelledby)ariaLabelledbyBecomes aria-labelledby. Point it at the ID of another element whose text should become this block’s accessible name.
RoleawtRoleBecomes the role attribute. Overrides the element’s ARIA role. The list offers only roles that suit the element.
Language (lang)awtLangBecomes the lang attribute. Set it when this block’s content is in a different language from the page, as a BCP-47 code like “fr”.