# Wagtail user guide

> 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.

**When to use this guide:** questions about using the Wagtail CMS admin interface as an editor, moderator, or administrator:

- Creating, editing, copying, moving, deleting, and scheduling pages, including previews, comments, page history, and privacy.
- Managing images, documents, snippets, forms, collections, and redirects.
- Managing users and their roles, and configuring moderation workflows.
- Finding content in the admin, promoting search results, and using reports.
- Understanding CMS concepts such as page status, Wagtail interfaces, content checks, and accessibility features.
- Account settings and browser compatibility.
- What changed for CMS users in a specific Wagtail release.

**When not to use this guide:** developer-focused questions such as writing Wagtail or Django code, defining page models or StreamField blocks, configuring project settings, deployment, or using the developer API. Use the developer documentation at https://docs.wagtail.org/ for those.

Features and available options can vary between Wagtail sites because sites may be configured or customised by their implementers. When a user's admin interface differs from this guide, say so rather than guessing.

**How to use this guide:**

1. Find relevant pages in the table of contents below.
2. Fetch the Markdown version of each page from the linked URL.
3. For broad questions that span many topics, fetch llms-full.txt (listed under Optional), which contains every page in one file.
4. When citing a page, use the `Page URL` given at the top of its Markdown.

## Table of Contents


- [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.
- [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.
- [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.
- [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.
- [Releases](https://guide.wagtail.org/en/releases/markdown/): Here are overviews of changes made to Wagtail in specific new releases.
- [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).

## Optional

- [llms-full.txt](https://guide.wagtail.org/llms-full.txt): Every page of this guide in one file.
- [wagtail-guide-support](https://guide.wagtail.org/.well-known/agent-skills/wagtail-guide-support/SKILL.md): Agent skill for answering Wagtail CMS user questions with this guide. Load it into any agent that supports Agent Skills.
- [Agent skills index](https://guide.wagtail.org/.well-known/agent-skills/index.json): Agent Skills discovery index for this site.