---
title: "New in Wagtail 8.1"
description: "Discover Wagtail 8.1: SEO metadata directly in content checks, better sitemaps for multilingual sites, and API v3 improvements"
last_modified: "2026-11-03"
---
> 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/releases/new-in-wagtail-8-1/

# New in Wagtail 8.1

## On this page

- [Wagtail Space 2026](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#wagtail-space-2026)
- [SEO power tools: page metadata](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#seo-power-tools-page-metadata)
- [Varying page responses](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#varying-page-responses)
- [API v3 for structured content](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#api-v3-for-structured-content)
- [API v3 workflow operations](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#api-v3-workflow-operations)
- [Faster, better sitemaps for multilingual sites](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#faster-better-sitemaps-for-multilingual-sites)
- [Prototype command line interface (CLI)](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#prototype-command-line-interface-cli)
- [Official agent skills](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#official-agent-skills)
- [Other UI improvements](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#other-ui-improvements)
- [Let us know what you think](https://guide.wagtail.org/en/releases/new-in-wagtail-8-1/#let-us-know-what-you-think)

Here are highlights from Wagtail 8.1. For full technical details, view the complete [v8.1 release notes](https://docs.wagtail.org/en/stable/releases/8.1.html).

## Wagtail Space 2026

![Wagtail Space 2026, 18-20 November, A free virtual event for people who are improving the world through code and content. With rocket visual above and a space background](https://guide-media.wagtail.org/images/wagtail.org_wagtail-space-2026_.width-900.png)

Our flagship [Wagtail Space](https://wagtail.org/wagtail-space-2026/) conference returns! Coming up 18-20 November, a free virtual event for people who are improving the world through code and content. 22 presentations over two days of talks and one day of community events. [Register to join us](https://wagtail.org/releases-register) 🚀

## SEO power tools: page metadata

The [Checks](https://guide.wagtail.org/en/reference/content-checks/) panel and the userbar's Checks dialog now show each page's meta title and meta description, with their length measured against how search engines typically display them. You can also expand **View more meta tags** to inspect every tag that search engines and social media link previews will see.

![Checks userbar dialog with metadata viewer opened to view all OpenGraph meta tags](https://guide-media.wagtail.org/images/Checks_userbar_dialog_with_metadata_viewer_ope.width-900.png)

This makes it much easier to spot titles and descriptions that search engines will truncate, providing feedback on drafts without a need for separate tools that only work on published pages.

Thank you to [Freedom of the Press Foundation](https://freedom.press/) for their sponsorship of this feature!

## Varying page responses

When [configured by a developer](https://docs.wagtail.org/en/latest/advanced_topics/varying_page_responses.html#varying-page-responses), Wagtail can now serve more than one version of the content of a page at the same URL. This general-purpose capability can be used for content negotiation: for example to serve structured data with APIs, or Markdown for AI agents as a form of agent readiness. Here is an example rendering a page as Markdown:

![Screenshot of a Markdown version of a demo page](https://guide-media.wagtail.org/images/mardown_rendering_of_pages.width-900.png)

## API v3 for structured content

The [v3 API](https://guide.wagtail.org/en/releases/new-in-wagtail-8-0/#manage-content-with-the-new-v3-api) preview gained a large batch of improvements since Wagtail 8.0, most notably:

- **Table blocks and nested inline relations** can now be created and updated through the API, rather than needing to be edited in the Admin interface.
- **More complete schemas**: the API now self-documents more of your content model.
- **More reliable Markdown**: rich text is converted to Markdown more consistently, particularly styled text inside links, line breaks, multi-paragraph quotes, and nested lists. This makes the Markdown output of pages far closer to what you see on the site.

Here is an example of the structured schema, with the fields of a specific body block clearly visible:

![ContentPageSchema with a body with two item types. AlertItem is expanded to reveal its alert type can be &#x27;Warning&#x27; or &#x27;Note&#x27;](https://guide-media.wagtail.org/images/ContentPageSchema_with_two_block_types_in_body.width-900.png)

As in Wagtail 8.0, all of this needs a developer to enable the API. For developer documentation, see the [v3 API guide](https://docs.wagtail.org/en/latest/advanced_topics/api/v3/index.html).

## API v3 workflow operations

![Screenshot of the API docs viewer with v3 workflow operations. 5 state changes as POST, two GET for workflow status and history](https://guide-media.wagtail.org/images/Wagtail_v3_preview_api_workflow_operations.width-900.png)

The API now supports [workflow operations](https://guide.wagtail.org/en/how-to-guides/configure-workflows-for-moderation/) on pages and and compatible snippets, so integrations can submit content to a workflow without visiting the Admin interface.

## Faster, better sitemaps for multilingual sites

![Screenshot of a multilingual sitemap subset, with two entries with hreflang alternate links](https://guide-media.wagtail.org/images/multilingual_sitemap.width-900.png)

Sitemaps now include alternate links for translated pages, and list every locale of the site rather than only the default one. If you run a multilingual site, more of your translated content can be discovered by search engines.

## Prototype command line interface (CLI)

As part of the new [v3 API](https://docs.wagtail.org/en/latest/advanced_topics/api/v3/index.html#api-v3) preview, we are introducing a [prototype Wagtail CLI](https://wagtail.org/blog/prototyping-a-cli-for-wagtail/) to speed up and automate common operations on Wagtail projects. When the API is set up by a developer, CMS users can then use the command line interface to make content changes.

## Official agent skills

We now provide official [agent skills for developers](https://wagtail.org/ai/agent-skills-for-developers/), that work together with the CLI and the API. They are primarily intended for developers but also make AI agents work more effectively on all Wagtail-related tasks.

Here is an example that combines the CLI, the skills, and the API to make [content changes with DeepSeek Harness and Mistral Large 4](https://wagtail.org/blog/wagtail-api-in-action-content-ops-with-deepseek-harness/).

## Other UI improvements

This release also includes a range of smaller enhancements that improve day-to-day editing:

- When you move or rename a page, Wagtail no longer creates a redirect if the page isn't live, and no longer creates one if its URL doesn't actually change.
- The document upload form now lists the file types it accepts, so you know what's supported before choosing a file.
- Moving or renaming a page now clears the relevant pages from your site's front-end cache, so visitors see the updated address sooner.
- Uploaded avatars respect the orientation stored in the photo, so portrait photos no longer appear sideways in the Admin interface.
- Workflow action buttons are protected against double clicks, which could previously cause an error or overwrite another person's decision.
- Workflow actions are rejected if the task was updated by someone else while you were filling it in, rather than overwriting their change.
- In the slim Sidebar, nested submenu labels no longer become invisible.
- Copying a page with a long revision history no longer uses excessive memory.
- Audit log entries for copying pages, copying for translation, and creating aliases now reference the page you copied rather than its parent page.
- Rich text content is more reliable in the v3 API's Markdown output, particularly around links, line breaks, quotes, and nested lists.

Many behind-the-scenes fixes and performance improvements are also included.

## Let us know what you think

We thrive with feedback from our community. Make sure to [register for Wagtail Space 2026](https://wagtail.org/releases-register), and tell us how you find the new release!

---

To learn about future enhancements ahead of time 👉️ check out the [Wagtail roadmap](https://wagtail.org/roadmap/) and subscribe to the [Wagtail newsletter](https://wagtail.org/newsletter/).

*Last updated: November 3, 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.
        - [Manage sites](https://guide.wagtail.org/en/how-to-guides/manage-sites/markdown/): Learn how to manage Wagtail sites: list, add, edit, copy, and delete the site configurations that map hostnames to your page tree.
        - [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.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.
