# GitHub Pages

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.

## 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.

## FAQ

### 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.

---

HTML version: https://www.muxforms.com/docs/github-pages
Source: MuxForms (https://www.muxforms.com)