Documentation / Site Settings

Site Settings

Site Settings is the central configuration module for your Luminal CMS installation. It controls site identity, branding, typography, and display preferences.

Accessing Settings

Navigate to Site Settings in the System section of the admin navigation. All settings are stored in admin/data/site-settings.json.

Site Identity

  • Site Name — The primary name of your site. Displayed in the header.
  • Site Title — Used in browser title bars and SEO metadata.
  • Meta Description — Default description for search engines (can be overridden per-page).
  • Meta Keywords — SEO keywords for the site.

Logo Configuration

  • Enable Logo — Toggle between image logo and text logo in the header.
  • Logo Path — Path to the logo image (e.g., media/images/logos/logo.png).
  • Logo Max Width — Maximum width of the logo in pixels.
  • Full Width Header — Whether the header spans the full viewport width.

Tip: When the logo is disabled, the Site Name is displayed as text in the header using the configured header font settings.

Typography

Header Font

  • Font Family — The font used for the site name in the header.
  • Font Size — Size in rem units.
  • Font Color — Hex color code.
  • Bold / Italic — Style toggles.

Body Font

  • Font Family — The default font for page content.
  • Font Size — Base size in rem units.
  • Font Color — Default text color.

Custom fonts can be uploaded and managed via the Font Manager module.

Home Page

  • Home Page Slug — The page slug that loads when visitors hit the site root (/). Set this to the slug of your desired home page.

Layout

  • Main Content Margin Top — Pixels of space between the header/menu and the main content area. Adjust this if content overlaps with a sticky menu.

Footer

  • Contact Email — Displayed in the footer.
  • Phone — Contact phone number.
  • Address — Physical address.
  • Credits — Footer credit text (e.g., "Powered by Luminal CMS").
  • Social Links — Links to social media profiles.

Background Settings

Background images and videos are managed separately via the Background Manager module. Site Settings controls whether backgrounds are enabled globally, while individual pages can override this with the include_bg flag.

User Management Media & Files All Documentation