---
title: "Manage sites"
description: "Learn how to manage Wagtail sites: list, add, edit, copy, and delete the site configurations that map hostnames to your page tree."
last_modified: "2026-10-14"
---
> Documentation Index
> Fetch the complete documentation index at: https://guide.wagtail.org/llms.txt
> Use this file to discover all available pages before exploring further.

Page URL: https://guide.wagtail.org/en/how-to-guides/manage-sites/

# Manage sites

## On this page

- [About sites](https://guide.wagtail.org/en/how-to-guides/manage-sites/#about-sites)
- [List sites](https://guide.wagtail.org/en/how-to-guides/manage-sites/#list-sites)
- [Add a site](https://guide.wagtail.org/en/how-to-guides/manage-sites/#add-a-site)
- [Edit a site](https://guide.wagtail.org/en/how-to-guides/manage-sites/#edit-a-site)

## **About sites**

A site in Wagtail is a configuration that connects a domain name (like "example.org") to a section of the page tree. When a visitor requests a page, Wagtail looks up the site whose domain name matches the request, then uses that site’s root page as the starting point to serve the right content.

Most projects have a single site, but Wagtail also supports [*multi-site*](https://docs.wagtail.org/en/stable/advanced_topics/multi_site_multi_instance_multi_tenancy.html#multi-site) installations, where one admin interface manages the content of several websites. In a multi-site project, you configure one site entry per hostname and point each one at a different root page. See [Multi-site](https://guide.wagtail.org/en/reference/multi-site/) for more on how multi-site projects work.

## **List sites**

Go to **Settings > Sites** from the [Sidebar](https://guide.wagtail.org/en/how-to-guides/find-your-way-around/) to see all of the sites configured for your project. The Sites listing shows the following columns for each site:

- **Site**: the hostname the site responds on.
- **Port**: the port number the site responds on.
- **Site name**: a human-readable name for the site.
- **Root page**: the page served at the site’s root URL.
- **Default?**: whether the site is the default site.

You can sort the listing by clicking the column headings, such as **Site** or **Port**.

## **Add a site**

Click **Add a site** in the top-right of the Sites listing to create a new site. Then fill in the following fields:

- **Hostname**: the hostname the site responds on, excluding the scheme, port, and path. For example, *www.example.com*. This field is required.
- **Port**: the port number the site responds on. Set this to something other than 80 if you need a specific port number to appear in URLs (for example, development on port 8000). Set this to 443 for HTTPS. This does not affect request handling, so port forwarding still works. This field is required.
- **Site name**: a human-readable name for the site. Wagtail does not use this itself, but it is suitable for use on the site front-end, such as in page titles.
- **Root page**: the page served at the site’s root URL. Choose the page that should be the home page for this hostname. This field is required.
- **Is default site**: if checked, this site handles requests for all other hostnames that do not have a site entry of their own. Only one site can be the default.

Click **Save** to create the site.

## **Edit a site**

Click the hostname of a site in the Sites listing to open it for editing. The edit screen uses the same fields as the **Add a site** form. Make your changes and click **Save**.

From the edit screen you can also:

- **Copy** the site, which opens the **Add a site** form pre-filled with the existing site’s values. This is useful when setting up a new hostname that is similar to an existing one.
- **Delete** the site, which takes you to a confirmation page before the site is removed.

Warning

Site operations are dangerous and often limited to "superadmin" users only. Deleting a site is permanent and cannot be undone. It removes the site configuration only; the pages in the site’s root page and below are not deleted. Be careful not to delete the default site or a site that is in use.

*Last updated: October 14, 2026*


## Site Map

Here is a list of every page of this guide:

- [Wagtail user guide](https://guide.wagtail.org/en/markdown/): This documentation is written for anyone creating content or managing content production in Wagtail. It covers everything you can expect when using a standard Wagtail site.
    - [Getting started](https://guide.wagtail.org/en/getting-started/markdown/): Here are our step-by-step tutorials to learn Wagtail concepts.
        - [Overview](https://guide.wagtail.org/en/getting-started/overview/markdown/): If you're brand new to Wagtail, we recommend you go through our guides in sequence. Otherwise, you can click through the different categories below to learn more about different aspects of Wagtail.
    - [How-to guides](https://guide.wagtail.org/en/how-to-guides/markdown/): Use our guides to learn how to do a specific task in the CMS.
        - [Find your way around](https://guide.wagtail.org/en/how-to-guides/find-your-way-around/markdown/): This section describes the different pages that you will see as you navigate around the CMS, and how you can find the content that you are looking for.
        - [Manage pages](https://guide.wagtail.org/en/how-to-guides/manage-pages/markdown/): How to create, edit, copy, and manage pages in the Wagtail admin, including block-based editing, comments, privacy, history, and aliases.
        - [Manage documents](https://guide.wagtail.org/en/how-to-guides/manage-documents/markdown/): Documents such as PDFs can be managed from the Documents interface, available in the left-hand menu.
        - [Manage images](https://guide.wagtail.org/en/how-to-guides/manage-images/markdown/): If you want to edit, add or remove images from the CMS outside of the individual pages you can do so from the Images interface.
        - [Manage snippets](https://guide.wagtail.org/en/how-to-guides/manage-snippets/markdown/): Snippets allow you to create elements on a website once and reuse them in multiple places.
        - [Manage forms](https://guide.wagtail.org/en/how-to-guides/manage-forms/markdown/): Build and manage forms from the Wagtail admin without any technical expertise, and review the submissions they collect.
        - [Manage collections](https://guide.wagtail.org/en/how-to-guides/manage-collections/markdown/): Access to specific sets of images and documents can be controlled by setting up ‘collections’.
        - [Manage redirects](https://guide.wagtail.org/en/how-to-guides/manage-redirects/markdown/): A redirect ensures that when a page is no longer available (404), the visitor and search engines are sent to a new page.
        - [Manage users and roles](https://guide.wagtail.org/en/how-to-guides/manage-users-and-roles/markdown/): As an administrator, a common task will be adding, modifying or removing user profiles.
        - [Configure workflows for moderation](https://guide.wagtail.org/en/how-to-guides/configure-workflows-for-moderation/markdown/): Workflows allow you to configure how moderation works on your site. Workflows are sequences of tasks, all of which must be approved before the workflow completes (by default, this results in the publication of the page, but depends on your site settings).
        - [Promote search results](https://guide.wagtail.org/en/how-to-guides/promote-search-results/markdown/): Promoted search results are an optional Wagtail feature. For details of how to enable them on a Wagtail installation, see Promoted search results.
        - [Manage API tokens](https://guide.wagtail.org/en/how-to-guides/manage-api-tokens/markdown/): API tokens let applications and integrations connect to the Wagtail API on behalf of a user account. Learn how to create, rename, and revoke them.
    - [Concepts](https://guide.wagtail.org/en/concepts/markdown/): Wagtail has strong opinions about CMS best practices. This section describes why Wagtail works how it does from a user’s perspective.
        - [Wagtail interfaces](https://guide.wagtail.org/en/concepts/wagtail-interfaces/markdown/): A Wagtail interface is a screen in the Wagtail portal where you can manage a particular content type. The following are the several interfaces available to you in the Wagtail CMS.
        - [Pages](https://guide.wagtail.org/en/concepts/pages/markdown/): You can use Wagtail Pages to organize the content of your Wagtail websites. It's common for a typical website to have multiple web pages, and the web pages themselves can have several sections. The same is true for Wagtail pages.
        - [Reports](https://guide.wagtail.org/en/concepts/reports/markdown/): Reports are lists of pages that match a specific search. These lists give you an overview of the different actions taken on your website.
        - [Users status](https://guide.wagtail.org/en/concepts/users-status/markdown/): A Wagtail user can either be active or inactive. A user is active if they have the right permissions to log in and perform any action in the Admin interface.
        - [Page status](https://guide.wagtail.org/en/concepts/page-status/markdown/): Page status has to do with the current state of your pages. Your pages can be in one of seven different states.
        - [Accessibility features](https://guide.wagtail.org/en/concepts/accessibility-features/markdown/): An overview of the accessibility features built into the Wagtail admin interface, including navigation, keyboard support, and screen reader aids.
        - [Scheduled publishing](https://guide.wagtail.org/en/concepts/scheduled-publishing/markdown/): Schedule pages and snippets to go live at a specific date and time, and manage scheduled content revisions.
        - [Wagtail API](https://guide.wagtail.org/en/concepts/wagtail-api/markdown/): The Wagtail API lets other applications and integrations read, create, edit, and publish your content, with the same permissions and rules as the Admin interface.
    - [Reference](https://guide.wagtail.org/en/reference/markdown/): Our reference material gets to the point, giving the key information at a glance.
        - [Browser compatibility](https://guide.wagtail.org/en/reference/browser-compatibility/markdown/): For the best experience and security, we recommend that you keep your browser up to date.
        - [Content checks](https://guide.wagtail.org/en/reference/content-checks/markdown/): A built-in content quality checker system to meet high standards on accessibility, SEO, tone of voice, and any other aspect of content performance.
            - [Page metadata](https://guide.wagtail.org/en/reference/content-checks/page-metadata/markdown/): How Wagtail checks page metadata fields, including previews for search engines and other crawlers
        - [Account settings](https://guide.wagtail.org/en/reference/account-settings/markdown/): User account settings are specific to your account. Includes user preferences, notification settings, and more.
        - [Multi-site](https://guide.wagtail.org/en/reference/multi-site/markdown/): Reference for running multiple websites with Wagtail: how sites map hostnames to pages, and multi-site, multi-instance and multi-tenancy compared.
    - [Releases](https://guide.wagtail.org/en/releases/markdown/): Here are overviews of changes made to Wagtail in specific new releases.
        - [New in Wagtail 8.1](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/markdown/): Discover Wagtail 8.1: SEO metadata directly in content checks, better sitemaps for multilingual sites, and API v3 improvements
        - [New in Wagtail 8.0](https://guide.wagtail.org/en/releases/new-in-wagtail-8-0/markdown/): Discover Wagtail 8.0: the new v3 API to create, edit, and publish content programmatically, plus improvements to the site switcher, workflow details, and image handling.
        - [New in Wagtail 7.4](https://guide.wagtail.org/en/releases/new-in-wagtail-7-4/markdown/): Explore Wagtail 7.4: refined autosave, draft‑saving incomplete blocks, customizable listings, enhanced search, content checks, UI tweaks, and security fixes.
        - [New in Wagtail 7.3](https://guide.wagtail.org/en/releases/new-in-wagtail-7-3/markdown/): New features and other highlights from Wagtail 7.3: autosave, llms.txt, image performance
        - [New in Wagtail 7.2](https://guide.wagtail.org/en/releases/new-in-wagtail-7-2/markdown/): Highlights from the new admin features in Wagtail 7.2
        - [New in Wagtail 7.1](https://guide.wagtail.org/en/releases/new-in-wagtail-7-1/markdown/): Highlights from the new admin features in Wagtail 7.1
        - [New in Wagtail 7.0](https://guide.wagtail.org/en/releases/new-in-wagtail-7-0/markdown/): Highlights from the new admin features in Wagtail 7.0
        - [New in Wagtail 6.4](https://guide.wagtail.org/en/releases/new-in-wagtail-6-4/markdown/): Highlights from the new admin features in Wagtail 6.4
        - [New in Wagtail 6.3](https://guide.wagtail.org/en/releases/new-in-wagtail-6-3/markdown/): Highlights from the new admin features in Wagtail 6.3
        - [New in Wagtail 6.2](https://guide.wagtail.org/en/releases/new-in-wagtail-6-2/markdown/): Highlights from the new admin features in Wagtail 6.2
        - [New in Wagtail 6.1](https://guide.wagtail.org/en/releases/new-in-wagtail-6-1/markdown/): Highlights from the new admin features in Wagtail 6.1
        - [New in Wagtail 6.0](https://guide.wagtail.org/en/releases/new-in-wagtail-6-0/markdown/): Highlights from the new admin features in Wagtail 6.0
        - [New in Wagtail 5.2](https://guide.wagtail.org/en/releases/new-in-wagtail-5-2/markdown/): Highlights from the new admin features in Wagtail 5.2
        - [New in Wagtail 5.1](https://guide.wagtail.org/en/releases/new-in-wagtail-5-1/markdown/): Here are highlights from Wagtail 5.0. For more details, view the full v5.0 release notes.
        - [New in Wagtail 5.0](https://guide.wagtail.org/en/releases/new-in-wagtail-5-0/markdown/): Here are highlights from Wagtail 5.0. For more details, view the full v5.0 release notes.
        - [New in Wagtail 4.2](https://guide.wagtail.org/en/releases/new-in-wagtail-4-2/markdown/): With Wagtail 4.0, 4.1, and now 4.2 – we've added many substantial updates to the Wagtail page editor as well as some other tools that support every member of a content team.
        - [New in Wagtail 4.1](https://guide.wagtail.org/en/releases/new-in-wagtail-4-1/markdown/): With Wagtail 4.0 and 4.1, we've added many substantial updates to the Wagtail page editor as well as some other tools that support every member of a content team.
    - [About](https://guide.wagtail.org/en/about/markdown/): The User Guide is a website to help content editors, moderators, administrators, and other users learn how to use the Wagtail content management system (CMS).
        - [Privacy policy](https://guide.wagtail.org/en/about/privacy-policy/markdown/): What information the Wagtail User Guide collects when you visit or use the site, why we collect it, and who we share it with.
        - [Documentation formats](https://guide.wagtail.org/en/about/documentation-formats/markdown/): The user guide is available in different formats, for people and for their agents: web pages, Markdown, llms.txt, an agent skill, a Model Context Protocol server, WebMCP tools, and an API.
        - [Digital emissions](https://guide.wagtail.org/en/about/digital-emissions/markdown/): How we measure the Wagtail User Guide's carbon emissions, and the services the site relies on.
