Home

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.

1.0.0 Stable: 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
Show recent comments with custom markup	Recent comments
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
Understand query costs and run load checks	Performance
Diagnose a problem	Troubleshooting
Run the example and tests	Example and testing
Read the current release scope	Release 1.0.0
Understand the stable contract	Stability
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. Version 0.2.0 includes English, Russian, German, French, Spanish and Brazilian Portuguese across the UI, moderation and emails; see Languages. No external comments platform, Redis, Celery or CDN is required.

---

Documentation home · Installation →