Skip to content
Alex edited this page Oct 18, 2026 · 5 revisions

Commentail documentation

Self-hosted comments for Wagtail CMS. Add moderated discussions to Wagtail Pages and registered Django models using your site's accounts, templates and styles.

0.1.1 Beta: Wagtail 7.4.3+ / Django 5.2 or 6.0; Wagtail 8.0 / Django 5.2, 6.0 or 6.1; Python 3.12–3.14; file SQLite and PostgreSQL 16. Published 0.1.0 retains Wagtail >=7.4.3,<7.5 and Django 5.2 support.

Find your guide

Your task Guide
Connect a Wagtail site Installation
Choose site/page behavior and Python options Configuration
Review messages and delegate access Moderation
Maintain word rules in bulk Rules and CSV
Understand guest verification Guest comments
Understand threads and edit restrictions Replies and editing
Deliver email and schedule cleanup Email and worker
Match the host theme Styling
Replace markup and email layouts Templates
Describe published comments to search engines Structured data
Supply avatars, names or CAPTCHA Callbacks
Add comments to other Django models Object adapters
Understand access and stored data Security and privacy
Prepare a deployment Deployment
Diagnose a problem Troubleshooting
Run the example and tests Example and testing
Read the current release scope Release 0.1.1
Compare versions Changelog
See planned work Roadmap
Read the initial release scope Release 0.1.0
Support development Support

Recommended first run

  1. Complete Installation on a test site.
  2. Start with Review all, the default moderation policy.
  3. Configure SMTP and schedule the worker before enabling guests.
  4. Exercise publication, a reply and an eligible edit.
  5. Adapt the theme and assign site-scoped moderator rights.

Plain text, server-rendered HTML and progressive JavaScript keep integration independent of a frontend framework. English and Russian UI are included. No external comments platform, Redis, Celery or CDN is required.


Documentation home · Installation →

Clone this wiki locally