`django-wm`

django-wm lets you add Webmention functionality to your Django project with minimal setup.

Upgrading

Please check the changelog before upgrading.

Major versions introduce breaking changes which may require code changes in your application. Please check the upgrade guide for full instructions on how to handle these.

Minor versions may require a database migration for new features - this will be noted in the changelog and the wiki release page when necessary.

Getting started

Setup instructions.

Code for an example project.

All done? You can use the testing tool to make sure it works.

Features

Endpoints:

/webmention: Receives incoming Webmentions from other sites.

/webmention/get: Used to retrieve Webmentions for a page on your site.
e.g. /webmention/get?url=/my-article will return any received Webmentions that target /my-article on your site.

// /webmention/get?url=/my-article
{
  "target_url": "https://my-site.org/my-article",
  "mentions": [
    {
      "hcard": {
        "name": "Jane Bloggs",
        "avatar": "https://gravatar.com/janebloggs",
        "homepage": "https://jane-bloggs-example.org"
      },
      "quote": null,
      "source_url": "https://jane-bloggs-example.org/some-article",
      "published": "2020-01-17T21:45:24.542Z",
      "type": "webmention"
    }
  ]
}

WebmentionHeadMiddleware adds your /webmention endpoint to the headers of your pages so that it can be discovered by other sites.
{% webmentions_endpoint %} template tag to include your /webmention endpoint to your Django templates HTML element.
MentionableMixin enables automatic submission of Webmentions to other sites when you mention them in your content.

Release files for django-wm 4.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-wm 4.2.0
File	Size	Uploaded
django_wm-4.2.0.tar.gz	60.1 kB	Jan 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-wm 4.2.0
File	Interpreter	ABI	Platform	Reset
django_wm-4.2.0-py3-none-any.whl 89.0 kB Jan 7, 2026	Python 3	none	any	Details

Total release size: 149.1 kB

Release files / django_wm-4.2.0.tar.gz

Download URL	django_wm-4.2.0.tar.gz
Size	60.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`5053889009eba506c1411bd2f43fffdb0fda69c7cd9294dd6dc647e1e468eb42`
BLAKE2b-256 checksum How to use checksums	`c964bd5ec0d07c0c6bda86678f5b6f8ded4e4549de184ed3d0bf2c290b181739`
Upload date	Jan 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.7`

Release files / django_wm-4.2.0-py3-none-any.whl

Download URL	django_wm-4.2.0-py3-none-any.whl
Size	89.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e9ed42149678edabe710732116bbce6b07b7a8b0044357e880ed4e1ef410ac72`
BLAKE2b-256 checksum How to use checksums	`61a6a7f0b6306a4ac121b2f2bc5d212b99983c86673e866e778eb69521d4784a`
Upload date	Jan 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.7`