Forminit.neocities.org  |  Add contact forms for Neocities sites
★ Neocities custom forms tutorial ★

Add Custom Forms to Neocities, In Your Own Style

Use Forminit to add contact forms, file upload forms, multi-step forms, and custom forms to your hand-coded Neocities site. Keep your own HTML, your own colours, and your own style.

Important: newer Neocities free accounts may block external form submissions. Use Neocities Supporter before connecting your form to Forminit. ✦ HTML forever ✦ Custom forms with your own style ✦

Why add custom forms to Neocities?

Neocities is great for personal sites, portfolios, fan pages, zines, pixel art pages, shrines, and retro web projects. A custom form lets visitors send you messages, requests, files, ideas, and feedback.

Forminit lets your own HTML form collect submissions, send notifications, block spam, and keep everything organised in a simple dashboard.

Good for

Contact pages, guestbooks, fan mail, art commissions, zine submissions, file upload forms, club pages, quizzes, surveys, and personal sites.

Keep your own style

Design the form with your own HTML and CSS. Make it cute, chaotic, minimal, retro, gothic, pixel-style, or anything that fits your Neocities site.

Make any form match your site

Forminit does not force a widget or template on your page. Build the form in your own Neocities style and send the answers to Forminit.

  • contact forms
  • file upload forms
  • multi-step forms
  • commission forms
  • guestbooks
  • custom styled forms

First: check your Neocities plan

Important: some newer free Neocities accounts block forms that send messages to another website. When this happens, your browser may show errors such as connect-src 'self' or form-action 'self'.

To submit forms directly to Forminit from Neocities, use Neocities Supporter, or use an older unrestricted account. Neocities Supporter gives your site more freedom to connect forms to services like Forminit.

If you stay on a restricted free account, the form may look perfect on the page, but the browser can block the submission before Forminit receives it.

Easy steps

Create your Forminit form

Log in to Forminit, create a new form, and copy your form URL. It looks like https://forminit.com/f/YOUR_FORM_ID.

Use Neocities Supporter

Upgrade your Neocities site to Supporter if your account blocks external submissions. This is required for newer restricted accounts because the browser may stop the form before it sends.

Paste and style your HTML form

Add the code below to your Neocities page. Replace YOUR_FORM_ID with your real Forminit form ID, then change the colours, labels, fields, borders, fonts, and layout to match your site.

Publish and test

Save your Neocities page, open it in the browser, submit a test message, and check your Forminit inbox.

Copy this Neocities custom form code

This is a simple custom HTML form. You can remove fields, add fields, change labels, and style everything with your own CSS. It works on Neocities accounts that allow external form submissions.

custom-form.html
<form action="https://forminit.com/f/YOUR_FORM_ID" method="POST" enctype="multipart/form-data">
  <label for="name">Name</label>
  <input id="name" name="fi-sender-fullName" type="text" placeholder="Your name" required>

  <label for="email">Email</label>
  <input id="email" name="fi-sender-email" type="email" placeholder="you@example.com" required>

  <label for="message">Message</label>
  <textarea id="message" name="fi-text-message" placeholder="Write your message here..." required></textarea>

  <label for="request-type">What are you sending?</label>
  <select id="request-type" name="fi-select-request-type" required>
    <option value="">Choose one</option>
    <option value="hello">Just saying hello</option>
    <option value="commission">Commission request</option>
    <option value="zine">Zine / fan page submission</option>
    <option value="feedback">Website feedback</option>
  </select>

  <label for="attachment">Optional file upload</label>
  <input id="attachment" name="fi-file-attachment" type="file">

  <button type="submit">Send message</button>
</form>

Demo custom contact form

Here is a real Forminit-style form. Use it as a contact form, commission form, feedback form, file upload form, or the final step of a multi-step form. Replace the form URL with your own before publishing.

If this does not submit on Neocities, check your browser console. A browser blocking error means your site needs Neocities Supporter or another host.

FAQ

Can I add custom forms to Neocities?

Yes. You can add HTML contact forms, guestbooks, file upload forms, surveys, and other custom forms with Forminit. Newer restricted free accounts may need Neocities Supporter first.

Why do I see a Content Security Policy error?

Your Neocities page is blocking submissions to another website. This can stop the form before it reaches Forminit.

Do I need anything complicated?

No. Your Neocities site only needs a normal HTML form. Forminit receives the message, file, or custom fields and keeps them organised for you.

Can I use file uploads?

Yes. Use a normal HTML form with enctype="multipart/form-data" if your Forminit plan supports file uploads and your Neocities account allows external form submissions.