---
title: How to put a signup form on a page
description: Place a signup form on any page, post or widget area with a shortcode or the block, and learn what visitors see and what Hive Mail does.
url: "https://hiveplugins.com/docs/hive-mail-put-a-signup-form-on-a-page/"
updated: "2026-10-28"
category: Hive Mail
---

# How to put a signup form on a page

Once a [signup form](/docs/hive-mail-signup-forms/) is saved, has at least one list and **The form is on**, show it with a shortcode or a block. Save the form first: the **Put it on a page** card says "Save the form first."

## With the shortcode

1. Open the form in **Audience** > **Forms**. In **Put it on a page**, press **Copy** next to **Shortcode**. It looks like `[hivemail_form id="3"]`.
2. Edit the page or post. Add a **Shortcode** block (or your page builder's shortcode element) and paste the code.
3. Update the page and view it.

## With the block

1. In the block editor press **+** and search for **Hive Mail signup form**.
2. Pick the form in the **Signup form** drop-down ("Choose a form…"). Forms that are off carry "(off)".
3. Update the page.

The editor shows a picture of the real form; nothing can be sent from it. You can use a form on several pages, or twice on one page. Developers: [Shortcodes and the signup form block](/docs/hive-mail-shortcodes-and-block/).

![The block inserter with the Hive Mail signup form block found by search.](https://hiveplugins.com/wp-content/uploads/2026/10/hivemail-forms-block-01.webp)

## What visitors see

A small form with the fields you chose (a red * marks required ones), your tick box, a CAPTCHA if on, and the button. It uses your theme's fonts and colours. With JavaScript the form is replaced by the thank-you message or the visitor goes to your redirect page; without it, the page reloads with the message where the form was. The form sets no cookie and stores no IP address.

![A signup form on a real page of the site, with an email box and a button.](https://hiveplugins.com/wp-content/uploads/2026/10/hivemail-forms-frontend-02.webp)

| Situation | Message |
| --- | --- |
| Accepted | Your thank-you message, or "Thank you. Please check your email to confirm." or "Thank you. You are subscribed." |
| Email missing or not valid | "Please enter a valid email address." |
| Required name empty | "Please fill in your name." |
| Mandatory box not ticked | "Please tick the box to agree." |
| Too many sends | "You have tried too many times. Please wait a few minutes and try again." |
| Page open over 24 hours | "This page was open for a long time. Please reload it and try again." |
| CAPTCHA failed | "We could not check that you are human. Please try again." |
| Form off, deleted or without a list | "This form is not available right now." |

People who manage Hive Mail see a one-line note where a form cannot show (turned off, no list, or deleted). Visitors see nothing.

## What Hive Mail does

The visitor is never told which of these happened, so nobody can find out who is on your list.

| Who sends | What happens |
| --- | --- |
| A new address | Creates a contact with source `form:<id>` and adds the lists and tags. Subscribed if the form subscribes straight away, otherwise Pending with a confirmation email. |
| Already Subscribed | Adds lists and tags quietly. No email. |
| Pending | Adds lists and tags and sends a new confirmation email, at most one every 5 minutes. |
| Unsubscribed | Always sends a fresh confirmation email. They stay Unsubscribed until they press its button. |
| Transactional | If the form asks for confirmation, sends one. Otherwise they become Subscribed at once. |
| Bounced, Complained or suppressed | Nothing. |
| A robot | A normal-looking thank-you; nothing stored or counted. |

Each send is added to the person's timeline as "Sent a signup form" with the wording they saw. Limits: 3 sends a minute and 10 an hour per visitor; at most 3 confirmation emails a day to one address and 20 an hour from one network. Over a limit, nothing is sent and nobody is told. Developers can change these with the `hivemail_form_rate_limits` and `hivemail_form_email_limits` filters ([Hooks: filters](/docs/hive-mail-hooks-filters/)).

> **Warning:** A real person who presses the button less than 3 seconds after the page was drawn sees the normal thank-you, but nothing is saved. This catches robots.

Cached pages are fine; a page cached for more than a day makes the visitor reload. If the form does not appear, see [Conflicts with other plugins and caching](/docs/hive-mail-conflicts-with-plugins-and-caching/).

This is information, not legal advice.

Next: [Double opt-in](/docs/hive-mail-double-opt-in/), [Spam protection and CAPTCHA](/docs/hive-mail-spam-protection-and-captcha/).
