MuxForms on GitHub Pages is the standard embed snippet in your layout or index.html. Allow https://username.github.io or your custom domain on the form; submissions never touch GitHub Actions unless you add them.
Docs
GitHub Pages
GitHub Pages serves static files only—MuxForms is the backend your repo does not need to host.
GitHub Pages
| Item | Value |
|---|---|
| Host | github.io or custom domain |
| Allowlist | Exact public origin |
| Build | Optional Jekyll; embed works either way |
| Secrets | Never commit ingest secrets |
index.html on the default branch
<!-- docs/index.html or root index.html --> <main> <h1>Contact</h1> <div data-form-id="FORM_UUID"></div> </main> <script src="https://www.muxforms.com/embed.js" defer></script>
Allowlist
For https://acme.github.io allow `https://acme.github.io`. For `https://docs.acme.com` on Pages, allow that hostname instead.
Common questions
- Project site vs user site URL?
- Allow the origin visitors use—https://user.github.io/repo/ still uses origin https://user.github.io.
- Custom domain?
- Allow https://www.yourdomain.com after DNS is live.
- Can Actions forward submissions?
- Prefer browser embed or server Action with secret in repo settings—not in the static HTML.
- Jekyll site?
- See /docs/jekyll for a layout partial; same embed.
Open source sites still need inbound mail.
One form id on the README site and the marketing repo.
Upgrade to Pro