Skip to main content

Forms

RoastHive provides a hosted form backend so you can collect submissions from visitors without writing any server-side code. You create a named form in the dashboard, add a small HTML snippet to your site, and submissions arrive in the RoastHive Inbox.

Creating a form​

Forms are scoped to a single site. To create one:

  1. Go to your dashboard and open the site you want to add a form to.
  2. Click the Forms tab.
  3. Click New Form and fill in the two fields:
    • Name (required, 1–100 characters) — a human-readable label for your own reference, e.g. Contact form.
    • Redirect URL (optional) — an absolute http:// or https:// URL where visitors are sent after a successful submission. If you leave this blank, RoastHive shows a built-in thank-you page instead.
  4. Click Create.

The form appears in the table with its name and a unique ID (a UUID). You'll need that ID in the next step.

Installing the form on your site​

Click the <> (code) icon on any form row to open the install instructions. There are two steps.

Step 1 — Add this script tag once inside your page's <head>:

<script src="https://www.roasthive.com/forms/v1.js" defer></script>
note

You only need to include this script once per page, even if you have multiple forms on the same page.

Step 2 — Place this HTML wherever you want the form to appear. Set data-roasthive-form to the form ID shown in your dashboard:

<form data-roasthive-form="YOUR_FORM_ID">
  <label>
    Name
    <input type="text" name="name" required />
  </label>
  <label>
    Email
    <input type="email" name="email" required />
  </label>
  <label>
    Message
    <textarea name="message" rows="4"></textarea>
  </label>
  <button type="submit">Submit</button>
</form>
tip

The fields shown above are just an example. You can add, remove, or rename any <input>, <textarea>, or <select> elements — RoastHive captures every field automatically using its name attribute. There are no restrictions on field names or structure.

Viewing submissions (Inbox)​

All submissions across all of your sites and forms land in Inbox, accessible from the sidebar.

The Inbox table shows three columns for each submission:

ColumnDescription
Date receivedWhen the submission was received
Form nameThe name you gave the form in the dashboard
Site nameThe site the form belongs to

Click the eye icon on any row to open a detail panel. The panel lists every submitted field as a key → value pair, matching the name attributes from your HTML.

To delete an individual submission, open its detail panel and click Delete.

Deleting a form​

On the Forms tab, click the trash icon next to the form you want to remove.

caution

Deleting a form is permanent and cannot be undone. However, any existing submissions for that form remain visible in the Inbox — they are not deleted along with the form.

See also​