plain.support

Provides support forms for your application.

Overview
Settings
Custom forms
Views
- Embedded forms
Security considerations
FAQs
Installation

Overview

You can add support forms to your application to collect user feedback, bug reports, and other messages. When a form is submitted, an email is sent to your support team.

# app/urls.py
from plain.urls import include, path, Router
from plain.support.urls import SupportRouter


class AppRouter(Router):
    namespace = "app"
    urls = [
        path("support/", include(SupportRouter)),
        # ...
    ]

# app/settings.py
SUPPORT_EMAIL = "support@example.com"

This creates a support form at /support/form/default/ that users can fill out. When submitted, an email is sent to your SUPPORT_EMAIL address with the user's name, email, and message.

Settings

Setting	Default	Env var
`SUPPORT_EMAIL`	Required	`PLAIN_SUPPORT_EMAIL`
`SUPPORT_FORMS`	`{"default": "..."}`	-

See default_settings.py for more details.

Custom forms

You can create custom support forms by extending SupportForm. The form uses ModelForm from plain.postgres.forms.

# app/forms.py
from plain.support.forms import SupportForm
from plain.support.models import SupportFormEntry
from plain import forms


class BugReportForm(SupportForm):
    browser = forms.TextField(max_length=100, required=False)

    class Meta:
        model = SupportFormEntry
        fields = ["name", "email", "message", "browser"]

Then register it in your settings:

# app/settings.py
SUPPORT_FORMS = {
    "default": "plain.support.forms.SupportForm",
    "bug-report": "app.forms.BugReportForm",
}

The form will be available at /support/form/bug-report/.

You can also customize the email notification by overriding the notify method:

class BugReportForm(SupportForm):
    # ...

    def notify(self, instance):
        # Send to a different channel, create a ticket, etc.
        pass

Views

You can use the following views for different scenarios:

SupportFormView: Renders the support form on a full page
SupportIFrameView: Renders the form in an iframe-friendly format
SupportFormJSView: Serves JavaScript for embedded forms

Embedded forms

Support forms can be embedded in other sites using an iframe:

<iframe src="https://example.com/support/form/default/iframe/" width="100%" height="600"></iframe>

Or using the provided JavaScript embed:

<div id="support-form"></div>
<script src="https://example.com/support/form/default.js"></script>

Security considerations

Most support forms allow users to type in any email address. Be careful, because anybody can pretend to be anybody else. Conversations either need to continue over email (which confirms they have access to the email account), or include a verification step (emailing a code to the email address, for example).

The SupportForm.find_user() method attempts to associate entries with existing users by email, but this does not confirm the submitter's identity.

FAQs

How do I customize the form templates?

You can override the default templates by creating your own templates at:

support/page.html: The full page template
support/iframe.html: The iframe-friendly template
support/forms/<form_slug>.html: The form rendering template
support/success/<form_slug>.html: The success message template

How do I view support form entries?

Support form entries are stored in the SupportFormEntry model. You can query them directly or use the admin interface if you have plain.admin installed with the SupportFormEntryAdmin registered.

Can I associate support entries with logged-in users?

Yes. When a user is logged in, the form automatically associates the entry with their account. If the user is not logged in (common with iframe embeds), the form will try to find an existing user by email address using find_user().

Installation

Install the plain.support package from PyPI:

uv add plain.support

Add plain.support to your INSTALLED_PACKAGES in app/settings.py:

# app/settings.py
INSTALLED_PACKAGES = [
    # ...
    "plain.support",
]

Set the required SUPPORT_EMAIL setting:

# app/settings.py
SUPPORT_EMAIL = "support@example.com"

Include the support URLs in your app's URL configuration:

# app/urls.py
from plain.urls import include, path, Router
from plain.support.urls import SupportRouter


class AppRouter(Router):
    namespace = "app"
    urls = [
        path("support/", include(SupportRouter)),
        # ...
    ]

Sync the database to create the SupportFormEntry table:

uv run plain postgres sync

Create the required templates. At minimum, you need a form template:

<!-- app/templates/support/forms/default.html -->
{{ form.as_fields }}
<button type="submit">Send message</button>

And a success template:

<!-- app/templates/support/success/default.html -->
<p>Thank you for your message! We'll get back to you soon.</p>

You also need to create an email template for notifications. See the plain.email package for template setup instructions:

<!-- app/emails/support_form_entry.html -->
<p>New support request from {{ support_form_entry.name }} ({{ support_form_entry.email }})</p>
<p>{{ support_form_entry.message }}</p>

Visit /support/form/default/ to see your support form.

Metadata

Release files for plain.support 0.34.9

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

Source distribution (sdist)

Source distribution for plain.support 0.34.9
File	Size	Uploaded
plain_support-0.34.9.tar.gz	16.1 kB	May 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for plain.support 0.34.9
File	Interpreter	ABI	Platform	Reset
plain_support-0.34.9-py3-none-any.whl 23.2 kB May 13, 2026	Python 3	none	any	Details

Total release size: 39.3 kB

Release files / plain_support-0.34.9.tar.gz

Download URL	plain_support-0.34.9.tar.gz
Size	16.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`b31b61fb15960ff87463d6526884a002bd1793fbc4df893a2c6e8d8e90db586d`
BLAKE2b-256 checksum How to use checksums	`668072cc3267bf6387676e3bcbf7e5b343f88e762cf5b7b9010970203883e7be`
Upload date	May 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / plain_support-0.34.9-py3-none-any.whl

Download URL	plain_support-0.34.9-py3-none-any.whl
Size	23.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9cb5aa22ee73ed6dd8f0f92c4b74b4ead735e3add6ce24b8ae587b1861e105f5`
BLAKE2b-256 checksum How to use checksums	`9a1e35b1e7d6d640e2d8b909697c1013a3fd256da528bf8c5ba449a3ab93f608`
Upload date	May 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.11.14 {"installer":{"name":"uv","version":"0.11.14","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`