Installation

Pigeon is a free plugin for Craft CMS 5. You can install it from the Plugin Store inside the control panel, or with Composer.

Requirements

  • Craft CMS 5.4.0 or later
  • PHP 8.2 or later
  • MySQL or PostgreSQL (whatever your Craft install already uses)

The guest support inbox works on every Craft edition, including Solo. Direct user-to-user messages require a multi-user edition (Team or Pro), because both parties are Craft user accounts.

Install with Composer

From your project root, require the package and install the plugin:

composer require justinholtweb/pigeon
php craft plugin/install pigeon

The install step runs Pigeon’s migration, which creates its database tables. If you use the Plugin Store instead, search for Pigeon and click Install — Craft handles both steps for you.

After installing

  1. Open Settings → Plugins → Pigeon and review the settings — at minimum, set who should be notified of new support messages and (optionally) an attachments volume.
  2. Grant your team the permissions they need to read and reply to threads.
  3. Add a contact form to a front-end template so visitors can start a conversation.

Queue & email

Pigeon sends notification emails through Craft’s queue. Make sure your queue runs (Craft runs it automatically on web requests by default, or via php craft queue/run / a daemon in production) and that your Craft email settings are configured.