Letterbox

GitHub Pages publishes static files from a repository. It runs no server code, so it cannot receive form submissions itself.

A hosted Letterbox form fills that gap. You add one link, messages arrive by email, and nothing extra is stored in your repository.

Set it up

1. Create your form

   Sign up for free, add your email address as a recipient and create a contact form.

   Step-by-step account setup in the documentation →

2. Copy its link

   Your profile shows each form's link. It looks like this, and Pro and higher tiers can give it a custom name:

   https://ltrbx.contact/your-form-id

3. Add the link to your site

   In any Markdown page, such as index.md:

   [Contact us](https://ltrbx.contact/your-form-id)

   Or in an HTML page or layout:

   <a href="https://ltrbx.contact/your-form-id">Contact us</a>

   Commit and push the change. The link goes live when GitHub Pages rebuilds your site.

   The same Markdown link works in a repository README, so people can also reach you from the project page.

   GitHub Pages builds sites with Jekyll by default. To keep the link in one place, see Contact form for Hugo and Jekyll

4. Send a test message

   Publish your site, open the link and send yourself a message. It is delivered to your recipient email address.

Good to know

• Your email address never appears in your site's code. Visitors only see the form.
• Spam filtering is built in on every tier.
• Letterbox hosts the form page. It does not yet accept submissions from form markup on your own pages, and file attachments are not supported.
• The Free tier includes 2 forms, 1 recipient and 5 messages a week. Compare plans