Skip to content

Open source website builder and Webflow alternative. Webstudio is an advanced visual builder that connects to any headless CMS, supports all CSS properties, and can be hosted anywhere, including with us.

10.0 KB
Raw Blame

description: Set project-wide configuration, including redirects, authentication, and publishing options.

⚙️ Project settings

Project settings are located in the top left by clicking the Webstudio logo > Project settings.

Builder menu with Project settings near the top

General

  • Site Name – Used to output WebSite structured data to clearly define your website's identity.
  • Favicon – Output your logo in search engines, browser tabs, and more.
  • Custom Code – Global field to output scripts in the head. Custom Code is often used to add analytics scripts such as Google Analytics, PostHog, Plausible, and any other scripts/code you want to output on every page. Please note that this code does not output in the Builder, so your scripts aren't tracking Builder page views. For outputting a script in the body on every page, use a Slot. For example, add HTML Embed(s) to your Footer Slot so that it outputs on every page.
  • Compiler – Atomic CSS reduces the CSS file size by ~70% in many cases. See more below.

Emails

Configure recipients and Reply to here. Recipients are comma-separated mailboxes such as [email protected] or Name <[email protected]>; quote a display name that contains a comma. When the list is empty, new email resources fall back to the project owner's address. An email resource can inherit these recipients or use its own fixed recipient list; submitted Form values cannot choose team recipients. Set the subject and body on each email resource.

To send visitor email, create an email resource, select Visitor as its recipient, choose a named email input on the Form, and add the resource to the Form's Action. Its body starts empty. Webstudio always prepends a fixed confirmation sentence with the site's URL, followed by any body configured in the resource. The body can use normal resource bindings. When a Form includes file inputs, submitted files are attached to the outgoing email resource message by default. Turn off ‘Attach submitted files’ to omit them. This action runs alongside other actions, and its failure is reported without reversing an otherwise successful Form submission.

Reply to accepts one mailbox, with or without a display name: Acme Support <[email protected]> or [email protected]. Its address is for replies, and its optional name is the display name. Webstudio's authenticated From address stays fixed. Each email resource inherits this setting unless it has its own Reply to override. The resource override is empty by default.

Each email from a Form submission includes an X-Message-ID header. Email actions from the same submission share the header value, and a retry keeps it. Email subjects stay as configured.

An email resource without a custom body includes submitted Form fields and browser information by default when used on a Form. The automatic text includes submitted hidden fields, but excludes password inputs and Webstudio's internal bot fields. Set the resource body to customize the message, including an explicitly empty body. To use formData or browserInfo in a resource expression, define the resource on the Form; resources on an ancestor or global root cannot bind that Form's data.

Email resources inherit project recipients and Reply to unless overridden. Republish to update the settings included in a published site. On Webstudio Cloud, published email resources use the private Cloudflare email service when the EMAIL_SERVICE binding is configured. Saving settings or publishing does not itself send email; a visitor must submit the Form. Delivery fails explicitly if the service is unavailable. Self-hosted sites need a custom server-side email integration. The existing Contact email recipient setting continues to serve deprecated Webhook Forms.

Publishing

Atomic CSS

Project settings Publishing section with Generate atomic CSS when publishing enabled

When enabled, the class and CSS structure under the hood contains one style per class. This algorithm allows classes to be reused, significantly reducing the amount of CSS, ultimately leading to a faster-loading website.

For example, in the UI, you may create a Token called “Card” and give it a background color, padding, and a border-radius.

With atomic CSS enabled, it will output like this:

  .ceszdr {
    background-color: #fff;
  }
  .c1jykks9 {
    border-top-left-radius: 1rem;
  }
  .c31r7mo {
    border-top-right-radius: 1rem;
  }
  .cywm6f1 {
    border-bottom-left-radius: 1rem;
  }
  .c1q77ydo {
    border-bottom-right-radius: 1rem;
  }
  .cu6yur2 {
    padding: 20px;
  }

Even though this seems to take up more space, its benefits become apparent as you style more parts of the website. Now, anytime you add 20px of padding, it’ll automatically reuse the cu6yur2 class. Generally speaking, there are somewhat of a finite amount of styles you’ll use on your website, so as the website gets bigger, the CSS file does not grow proportionally – in fact, its growth slows down as the site gets bigger as it doesn’t need to continue creating classes for styles you’ve already used. Pretty neat.

The data

Let’s quantify the CSS file size savings when using atomic CSS on Webstudio.

  • 4-page brochure website
    • With atomic: 21 KB
    • Without atomic: 75 KB
  • 23-page SaaS website
    • With atomic: 23 KB
    • Without atomic: 83 KB

In both cases, enabling atomic CSS reduces the file size by around 72%!

Disabling atomic CSS

Even though atomic CSS improves website performance by reducing the CSS file size, there are use cases to disable it.

When exporting your Project to self-host it, you may want to modify CSS and classes outside of Webstudio. By disabling atomic CSS, your classes are human-readable, instead of using an optimized algorithm.

{% hint style="info" %} If you need classes to target but want to enable atomic CSS, you can add classes in the settings panel. These will always output exactly as they are entered. Watch this short video to learn more. {% endhint %}

When atomic CSS is disabled, your components will have two classes:

  1. A default class, such as w-box
  2. Your Tokens and Local Styles merged into another class

The same example from above looks like this when atomic is disabled:

.w-box-1 {
    background-color: rgb(255, 255, 255);
    border-radius: 1rem;
    padding: 20px;
}

Redirects

Redirects old URLs to new ones so that you don’t lose any traffic or search engine rankings. 301 and 302 status codes are available.

Authentication

Use Authentication to require HTTP Basic Auth credentials for one or more routes on custom domains.

This is useful when you want to protect:

  • A group of pages, such as /private/*
  • Dynamic routes, such as /blog/:slug
  • The home page, using /
  • A route that does not map cleanly to one page setting

To add a protected route:

  1. Open Project settings
  2. Go to Authentication
  3. Enter a route, such as /private or /docs/*, plus a login and password
  4. Click Add
  5. Publish the site

Routes use the shared path pattern syntax. The guide explains how static paths, parameters, and wildcards match URLs.

Project settings Authentication section with route, login, password, and Add controls

Login and password rules:

  • Login is required
  • Password is required
  • Login cannot contain :
  • Login and password cannot contain whitespace
  • Password can contain :

If a page has authentication in Page Settings and the same route is also protected in Project Settings, the page setting takes priority for that route.

{% hint style="info" %} Authentication applies to protected routes on custom domains. Staging domains have their own built-in password protection, described in Publishing & custom domains. {% endhint %}

{% hint style="warning" %} Authentication is a Pro feature for custom domains. You can publish to staging for free, but publishing authentication to custom domains requires a plan that includes it. {% endhint %}

For a single page, you can also configure authentication directly in Page settings.

Headers

Configure HTTP response headers to set browser and CDN behavior for your published site. You can apply a header to every route or only to matching paths. Webstudio Cloud supplies framing and referrer defaults when you have not set your own values; platform-managed headers cannot be changed here.

Marketplace

You can contribute free or paid templates by creating a Project and submitting it for review. Approved templates will appear in the Marketplace.

For more information, see Contributing to the Marketplace.

Related