Documentation

Deploy a site
Browse documentation

Forms

Give every form on your site somewhere to send. Each message lands in an inbox in your dashboard and in your email — no server, no PHP and no JavaScript. Included with Plus and Pro.

How Forms work

An HTML form sends what the visitor typed to the address in its action. Dplooy Forms gives you that address — an endpoint such as https://api.dplooy.com/f/my-site-contact. Each message is stored under the endpoint and emailed to you, and the visitor sees a short Message sent screen before returning to your page.

A contact form posting to an endpoint
<form action="https://api.dplooy.com/f/your-endpoint" method="POST">  <input type="hidden" name="_form" value="Contact">  <input type="text" name="name" placeholder="Your name" required>  <input type="email" name="email" placeholder="Your email" required>  <textarea name="message" placeholder="Your message"></textarea>  <!-- Spam protection — keep this hidden field -->  <input type="text" name="_gotcha" style="display:none" tabindex="-1" aria-hidden="true">  <button type="submit">Send</button></form>

The hidden _gotcha field is a spam trap, and _form labels the message so you can tell forms apart. Every starter form and AI prompt includes both.

Create an endpoint

  1. 1Open the Features menu at the top of your dashboard and click Forms. On a phone, it is in the menu behind the ☰ button. You can also open Forms from a site's own controls.
  2. 2Click New endpoint.
  3. 3Pick the Project the form lives on, or leave No project yet — assign later — you get the address either way.
  4. 4Name the form, for example Contact. Your endpoint's address fills itself in from the name and never changes after you create it, so a live form can't break.
  5. 5Choose where messages are emailed under Send submission notifications to, then click Create endpoint.

Connect your form

Pick whichever fits how the site was made:

  • Any HTML page — paste the endpoint address into your form's action and set method="POST". The </> button gives you a ready-made starter: contact, newsletter, quote request, booking enquiry, feedback or job application.
  • A site made with AI — click the robot button, then Copy prompt, and paste it into ChatGPT, Claude or the tool that made your page. The prompt carries your address and every rule the form needs.
  • Site Builder — choose the endpoint in the Contact Form block's settings.
  • AI chatbot — connect the endpoint in the chatbot's Contact Form tab, and messages from the chat land in the same inbox.

Assign it to your site

An endpoint only accepts messages once it belongs to a site. Until then it shows URL reserved, but not receiving yet — choose your site and click Assign. An endpoint created from a site's own controls is assigned already.

By default only the assigned site can send to its endpoint. If the form lives on a site hosted elsewhere, turn on Allow submissions from any website in the endpoint's settings.

Read and export messages

  • Messages appear under the endpoint in Forms, newest first and grouped by day, with search and Export CSV. Unread counts show on each endpoint.
  • Each one is also emailed to you as New form submission on your site's name. When the form has an email field, replying to that email answers the visitor.
  • Change the address or stop the emails in the endpoint's settings — Email me new submissions and Notification address. Left empty, emails go to your account address.
  • Pause an endpoint to stop new messages without deleting anything, and change the confirmation wording visitors see after sending.

Spam protection

People never see the hidden _gotcha field; bots fill it in. Anything that fills it is marked as spam, kept for a week so you can check it, never emailed and never counted toward your monthly limit. Submissions are also rate-limited per sender.

A sender's IP address is used for rate limiting in memory and then discarded. It is never stored, shown in the dashboard or included in a CSV export.

Limits by plan

Endpoints10 (3 per site)50 (5 per site)
Messages500 a month5,000 a month
Messages kept for30 days12 months

Forms are not part of the Free plan — they come with Plus ($4.99 a month) and Pro ($12.99 a month). Export anything you want to keep longer as CSV. After a downgrade, endpoints above the new allowance are frozen — on Free, all of them — and the messages you already have are kept.

Good to know

  • Forms take text fields only. A file input or enctype="multipart/form-data" is refused — ask visitors for a link to the file instead.
  • Test on your published site. Messages are not accepted from the Site Builder's preview or editor.
  • Several forms can share one endpoint; the _form label tells them apart.
  • Already use FormDuo? Connect it under Integrations in the dashboard header.

Step by step with pictures of every screen: Make your HTML contact form send you emails.