Using FormBeep with GitHub Pages#

GitHub Pages is ideal for portfolios, documentation, and student projects. Since GitHub Pages serves pure static files, you can’t run a backend to process forms. FormBeep solves this by routing submissions directly to your WhatsApp!

Step 1: Add Allowed Domain#

1. Go to your FormBeep Dashboard → Domains.
2. Add your GitHub Pages URL (e.g., yourusername.github.io).
3. Make sure to omit https:// and any trailing path.

Step 2: Add Embed Script#

In your repository, open the HTML file where you want the form (e.g., index.html or contact.html). Add the FormBeep script right before the closing </body> tag:

<script src="https://api.formbeep.com/v1/s/formbeep.js"
        data-api-key="YOUR_API_KEY"></script>

Step 3: Create the Form#

Create a standard HTML form. No messy JavaScript or API calls required on your end:

<form id="contact-form">
  <input name="name" type="text" placeholder="Your name" required>
  <input name="email" type="email" placeholder="you@example.com" required>
  <textarea name="message" placeholder="Your message" required></textarea>
  <button type="submit">Send Message</button>
</form>

Commit and push your changes. Wait a minute for the GitHub Action to deploy your site, then test your form on the live site!

Need help? If you encounter any issues or have questions about this guide, reach out at hello@formbeep.com or message @rishikeshs on Discord.