wagtail-metadata-mixin

https://img.shields.io/pypi/djversions/wagtail-metadata-mixin.svg

https://github.com/bashu/wagtail-metadata-mixin/actions/workflows/test.yml/badge.svg

OpenGraph, Twitter Card and Schema.org snippet tags for Wagtail CMS pages.

The current version is tested for compatiblily with the following:

Wagtail versions 6.3 to 7.4
Django versions 5.2, 6.0 and 6.1
Python versions 3.10 to 3.14

Authored by Basil Shubin, and some great contributors.

Installation

First install the module, preferably in a virtual environment. It can be installed from PyPI:

pip install wagtail-metadata-mixin

Requirements

You must have django-meta installed and configured, see the django-meta documentation for details and setup instructions.

Setup

First make sure the project is configured for django-meta.

Then add the following settings:

INSTALLED_APPS += (
    'wagtailmetadata',
)

and just include meta/meta.html template in your templates

{% load meta %}

<html {% meta_namespaces_schemaorg %}>
    <head {% meta_namespaces %}>
        {% include "meta/meta.html" %}
    </head>
    <body>...</body>
</html>

Check django-meta documentation for more details.

Usage

# models.py

from wagtail.models import Page, PageBase

from wagtailmetadata.models import MetadataPageMixin

# ensure MetadataPageMixin class goes before Page class
class CustomPage(MetadataPageMixin, Page):
    schemaorg_type = "Page"

    promote_panels = Page.promote_panels + MetadataPageMixin.panels

Contributing

If you like this module, forked it, or would like to improve it, please let us know! Pull requests are welcome too. :-)

License

wagtail-metadata-mixin is released under the MIT license.

Changes

3.0.0 (2026-08-15)

Bumped requirements: Wagtail 6.3+, Django 5.2/6.0/6.1, Python 3.10+, django-meta 2.5+.

2.0.2 (2021-11-29)

Fixed stupid typo.

2.0.1 (2021-11-29)

Added ru translation.

2.0.0 (2021-11-28)

Added Wagtail 2.15 and Django 3.2 support.
Dropped Wagtail 2.7 support.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wagtail_metadata_mixin-3.0.0.tar.gz (9.8 kB view details)

Uploaded Aug 15, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

wagtail_metadata_mixin-3.0.0-py3-none-any.whl (11.3 kB view details)

Uploaded Aug 15, 2026 Python 3

File details

Details for the file wagtail_metadata_mixin-3.0.0.tar.gz.

File metadata

Download URL: wagtail_metadata_mixin-3.0.0.tar.gz
Upload date: Aug 15, 2026
Size: 9.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for wagtail_metadata_mixin-3.0.0.tar.gz
Algorithm	Hash digest
SHA256	`24bb157bc63a3b669b47a041333e96258b16fe86dbe589304482dd26d7c2d55c`
MD5	`c87a010b2c14fdc15723621b08b5476d`
BLAKE2b-256	`5dc5c61e3b9d1e4705ab49de8c7607e46b249f2ba5c0ca0293ec636468be653c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for wagtail_metadata_mixin-3.0.0.tar.gz:

Publisher: release.yml on bashu/wagtail-metadata-mixin

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: wagtail_metadata_mixin-3.0.0.tar.gz
- Subject digest: 24bb157bc63a3b669b47a041333e96258b16fe86dbe589304482dd26d7c2d55c
- Sigstore transparency entry: 2472938494
- Sigstore integration time: Aug 15, 2026
Source repository:
- Permalink: bashu/wagtail-metadata-mixin@6a6e0c92c5ce6e53b0f865ac0ab555d58a3d9821
- Branch / Tag: refs/tags/3.0.0
- Owner: https://github.com/bashu
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@6a6e0c92c5ce6e53b0f865ac0ab555d58a3d9821
- Trigger Event: push