Site settings
Site settings, in the sidebar, holds values that apply across the whole site rather than to one page. The screen is divided into sections; select Save after changing any of them.
The line under the Site settings title states which version of Filament CMS the site is running, for example "Filament CMS 0.79.1". It is read from the installed package, so it changes when the site is updated. Quote it when reporting a problem.
| Section | Fields | What they do |
|---|---|---|
| Identity | Site name, Tagline, Logo, Favicon, Logo (dark theme), Favicon (dark theme) | Site name appears in the browser tab, in the footer and in search results. Favicon is the small icon in the browser tab. The two dark-theme fields are optional and are described in Logos in the dark theme. |
| Appearance | Skin, Light or dark | Override the skin and the light or dark mode the developer deployed. Left empty, the deployed defaults apply. A visitor can still switch between light and dark with the header toggle. |
| Editing | Edit blocks from the front end | Shows the pencil, drag handle and add button on the page itself for anyone permitted to edit content. Turned off, the panel is the only place to change a block; use this when demonstrating a page to a client without editing controls appearing over the copy. It does not affect drafts: signed-in editors still see unpublished work and the draft banner, and the page still reloads when a colleague publishes. |
| Defaults | Default social share image | The image a shared link shows when the page has no share image of its own. |
| Social links | Platform and URL pairs | The profiles listed in the site footer. They are also published in the site's structured data, so a search engine can connect the site to those accounts. Collapsed by default. |
| API access, Webhooks, Notifications | Various | Developer and team settings for the delivery API, rebuild notifications to other software, and Slack or email notifications. Covered in the developer documentation. |
| Organization | Legal name, Kind of organization, Telephone, Email, five address fields | Describes who publishes the site. No page displays these values; search engines read them. See Structured data. Collapsed by default. |
| Analytics | Head JavaScript, Body JavaScript | Tracking code, if the site uses any. Collapsed by default. Only trusted administrators should edit these fields. |
| Cookie consent | Show the consent banner, Privacy policy, What a visitor is asked about | The banner asking visitors what they consent to. Show the consent banner turns it on or off, Privacy policy is the page the banner links to, and What a visitor is asked about lists the consent categories. |
If the site uses analytics or any other tracking, the consent banner must be switched on. The code in Head JavaScript and Body JavaScript runs only after a visitor allows the consent category whose key the developer has set for analytics (analytics by default). If no category under What a visitor is asked about has that key, the tracking code never runs, and the screen shows a warning saying so. A tracking script that runs before a visitor consents is a legal problem in many jurisdictions, and holding the code back until consent is how the CMS prevents it.
Logos in the dark theme
A logo is usually an image file with its colors fixed in the file. On a site that offers a dark theme, dark artwork on a dark background becomes invisible, and no stylesheet can recolor an image file; the CMS does not recolor a logo. Site settings therefore has two optional fields, in the Identity section, for a second file.
Logo (dark theme) is used in the header whenever the page is shown in the dark theme. Left empty, the one Logo is used in both themes, which is correct for a logo that is legible on either background, such as a white knockout or artwork with its own background panel.
To decide whether a dark logo is needed:
- Open the public site.
- Switch to the dark theme with the sun and moon control in the site header.
- If the logo is hard to see, upload a dark-theme version in **Logo (dark theme)**.
Favicon (dark theme) follows a different rule. It follows the visitor's operating system setting, not the light and dark control in the site header, so switching the theme on the page does not change the icon in the browser tab. The browser draws the icon in its own tab strip, and the tab strip follows the operating system's setting regardless of the page's theme. An icon chosen to match the page could be invisible against the tab it sits in, so the icon is matched to the browser instead.
Both dark-theme files count as media in use, so the media library refuses to delete one while it is set here.