< Documentation Home

Site Settings

Site-wide configuration, stored in your project folder at .webhaste/site.config.json.

Open it via ⚙️ Site Admin ▾ → ⚙️ Site Settings in the top toolbar. This file travels with your project when you commit it to git or copy the folder to another machine — it's never published as part of your live site.

Fields

  • Site Name — used to build the default page title (Page Name | Site Name), shown in your template's footer via WebHaste CMS, and included in the link-preview tags WebHaste adds to every page.
  • Domain — your site's public address (for example example.com). WebHaste uses it to build your sitemap.xml, the full URL in each page's link-preview tags, and the homepage's Schema Markup. Without a domain, no sitemap is generated. See SEO and Search Engines.
  • Layout Template — which file in .webhaste/templates/ wraps your page content. Choosing "No layout (raw HTML)" publishes each page's content exactly as written, with no shared header/footer/nav. Individual pages can use a different template — see Using Multiple Templates.
  • New line creates — whether pressing Enter in Visual view starts a new <p> or a new <div>. Most sites want paragraphs; some hand-styled layouts prefer divs.
  • CSS Framework — Bootstrap 5, Tailwind, or none. This controls which classes WebHaste uses when it generates menus, blocks, and image presets. It doesn't load the framework for you — your template's <head> needs its own <link>/<script> tags for Bootstrap or Tailwind (the starter templates already include them).
  • Default Language — Set the site's primary language (default is "en" for English). Individual pages can be in different languages.
  • Deployment Target — where the 🚀 Publish button sends your site. There are four: Cloudflare Pages, Netlify, Render to folder (for SFTP and other manual deploys), and Packaged (a copy that opens straight from disk). See Publishing for details on each.
  • Local Render Folder — used by both the "Render to folder" and "Packaged" targets. Defaults to dist; set it to docs if you're deploying via GitHub Pages' "serve from /docs" option. If your project is in git and you don't want rendered output committed, add this folder to your .gitignore — and update that line if you change the folder here. (If a host or CI/CD job serves the folder straight from your repo, like GitHub Pages' docs, you do want it committed.)
  • Image Resize Max Dimension (px) — the longest edge, in pixels, that "Resize large images" shrinks uploads to. Defaults to 1920. See Images and Assets.
  • Enable template, style & script editing — adds Templates, Styles and Scripts tabs to the file list. Off by default, and it applies to this device only. See Editing Templates, Styles, and Scripts.
  • Schema Markup (Homepage) — optional structured data about your organization or local business, added to your homepage for search engines. See SEO and Search Engines.

Menus

🔗 Menus, also in the ⚙️ Site Admin menu, opens a separate dialog for your site's navigation, stored in .webhaste/nav.json. You can define multiple named menus (e.g. a header menu and a footer menu) with nested dropdown items, and your template controls where each one renders via placeholders like {{NAV:header}}. See Menus for the full walkthrough.

Other tools in the Site Admin menu

  • ↪️ Redirects — send visitors from an old page address to a new one. See URL Redirects.
  • 📋 Lists — manage reusable collections of entries. See Lists.
  • 🔍 Check Links — scan your whole site for broken internal links. See Checking Links.