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.2.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.

Configure Django email delivery through SMTP or another backend, and schedule background processing through the command or your existing task queue. See the 1.2.0 changes and upgrade guide.

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 and upgrade steps	Release 1.2.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 email delivery and its background schedule before enabling guests. Choose a real delivery backend and one background schedule.
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, Russian, German, French, Spanish and Brazilian Portuguese are available across the UI, moderation and emails; see Languages. No external comments platform, Redis, Celery or CDN is required.

---

Documentation home · Installation →