Add a contact form to Framer
In Framer you build the form as an HTML embed. That way you decide which fields it has, and submissions go to your inbox instead of yet another tool.
How to set it up
- Create a free account, add your website and copy the form's key.
- Add an Embed to the page and set it to HTML.
- Paste the code below and replace YOUR_ACCESS_KEY.
- Publish the site and send a test.
<form action="https://mailiy.com/api/submit" method="POST">
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY">
<input type="email" name="email" required>
<textarea name="message" required></textarea>
<input type="checkbox" name="botcheck" style="display:none">
<button>Send</button>
</form>
<script src="https://mailiy.com/client/script.js" defer></script>What to know about Framer
- Keep the script tag in the embed. It keeps the page in place after sending and shows the answer below the form.
- Style it with CSS inside the same embed.
Fields Mailiy understands
Every named field appears in the email and in the dashboard. Mailiy reads a few names itself and uses them to shape the mail and what happens after sending:
| Name | Effect |
|---|---|
subject | Subject of the email. Without it, Mailiy uses the subject from the form settings. |
from_name | Sender name shown in the inbox, for example the name of your website. |
email / replyto | Address of the person filling in the form. Hitting reply writes straight back to them. |
redirect | Address the browser goes to after sending, for example your own thank-you page. |
ccemail / bccemail | More recipients in Cc or Bcc, separated by semicolons. Only addresses confirmed in your account count. |
consent | Consent checkbox. If you require it in the dashboard, Mailiy refuses submissions without the tick. |
botcheck | Invisible trap for bots. As long as it stays empty, all is well. |
Sending files
With a file input, your Framer form accepts attachments too, up to five files with 10 MB in total. PDF, images, text and office files are allowed. Mailiy checks that each file's content matches its extension and refuses anything else.
For the browser to send the files, the form tag also needs enctype="multipart/form-data".
If no email arrives
Mailiy answers every submission with a message. Usually it comes down to one of these:
- Wrong key. The answer says “Invalid access key”. Copy the key from the dashboard again, without spaces before or after it.
- Domain not allowed. If you listed allowed domains in the dashboard, Mailiy only accepts submissions from them. Subdomains count too. To test on a preview address, add it for the time being.
- Field without a name. The browser leaves out any input without a name attribute. It is then missing from the email, and no error shows up.
- Too many tests in a row. Mailiy accepts five submissions a minute per form and visitor. After that you get “Too many submissions”, and after a short wait it works again.
- Mail in the spam folder. Check the spam folder first and mark the first mail as not spam. If the submission shows up in the dashboard, Mailiy received it.
- New recipient gets nothing. Additional recipients only get mail once they confirm their address with the link in the confirmation email.
After sending
Every submission lands in the dashboard, where you can search them and export them to CSV. In the form settings you can also set up an automatic reply that goes to the address in the email field, such as “Thanks, we'll get back to you within two days”.
If your team should see messages in chat too, Mailiy also posts them to Slack, Discord or Telegram. For your own workflows, webhooks send each submission as JSON to an address you choose.
Spam and privacy
The invisible botcheck field is a trap for bots. If they tick it, Mailiy drops the submission without storing or sending it. You can add more filters and a captcha in the dashboard.
Mailiy runs on servers in Germany and sets no trackers. What else a GDPR compliant form needs is covered in the GDPR checklist.
Frequently asked questions
Can I use the same form on several Framer pages?
Yes, put the embed with the same key on every page. To see which page a message came from, create a separate form per page in the dashboard or send a hidden field with the page name.
Do I need my own server for a contact form in Framer?
No. The form posts to Mailiy, and Mailiy sends the email. You need no PHP, no SMTP credentials and no server code.
Is it fine for the key to appear in the page source?
Yes. It only allows sending submissions to this one form and gives no access to your account. In the dashboard you choose which domains submissions are accepted from.
What does it cost?
The free plan includes 100 submissions a month for one website. Paid plans start at €9 a month.