github-pages gem limitations?

Custom plugins are limited; includes are allowed.

Replace form action URL with MuxForms div.

Different form UUID per _config.yml in each repo.

/docs/github-pages for deployment URL.

MuxForms on Jekyll uses _includes/muxforms.html with the embed snippet and {% include %} from contact.html. Allow https://username.github.io or your custom domain.

Docs

Jekyll

Jekyll on GitHub Pages cannot run arbitrary backends—MuxForms runs off-site while your site stays static.

Jekyll

Step	Detail
_includes/muxforms.html	Embed markup
contact.html	Include tag
_config.yml	mux_form_id site variable
Pages	Allow public origin

_includes/muxforms.html

<div data-form-id="{{ site.mux_form_id | default: 'FORM_UUID' }}"></div>
<script src="https://www.muxforms.com/embed.js" defer></script>

contact.html

---
layout: default
title: Contact
---
<h1>Contact</h1>
{% include muxforms.html %}

Common questions

github-pages gem limitations?: Custom plugins are limited; includes are allowed.
formspree migration?: Replace form action URL with MuxForms div.
Multiple sites?: Different form UUID per _config.yml in each repo.
Related doc?: /docs/github-pages for deployment URL.

Ruby-free form POST.

Same include on every GitHub Pages org site.

Upgrade to Pro