Jekyll

Jekyll builds static HTML, so a normal <form> can post directly to your endpoint. This works on GitHub Pages too, because nothing runs on a server.

1. Save your Public Key

Copy the Public Key from the Endpoint form’s General tab and add it to _config.yml:

_config.yml

url: "https://example.com"
surveyowl_key: "YOUR_FORM_PUBLIC_KEY"

Restart jekyll serve after changing _config.yml; Jekyll does not reload it automatically.

2. Create the form include

_includes/contact-form.html

<form action="https://api.surveyowl.co/v1/submit/{{ site.surveyowl_key }}" method="POST">
  <input type="hidden" name="redirect" value="{{ '/thank-you/' | absolute_url }}" />

  <label for="name">Name</label>
  <input id="name" name="name" required />

  <label for="email">Email</label>
  <input id="email" name="email" type="email" required />

  <label for="message">Message</label>
  <textarea id="message" name="message" required></textarea>

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

The hidden redirect field returns visitors to your own thank-you page after a successful submission. It is not saved as an answer.

3. Add the pages

contact.md

---
layout: default
title: Contact
permalink: /contact/
---

{% include contact-form.html %}

thank-you.md

---
layout: default
title: Thank you
permalink: /thank-you/
---

Thanks — your message was sent.

Run bundle exec jekyll serve, open /contact/, send a test response, and confirm it appears in Submissions.

Good to know

If your theme does not have a default layout, use the layout your other pages use.
On a GitHub Pages project site, also set baseurl: "/your-repo" in _config.yml so the redirect link points to the right place.
To stay on the page and show your own message, use the JavaScript example in the include.

Welcome

Hosted forms

Endpoint forms

Responses

Integrations

Build your form

Publish and share

Settings

Payments

Account and billing

1. Save your Public Key

2. Create the form include

3. Add the pages

Good to know

​1. Save your Public Key

​2. Create the form include

​3. Add the pages

​Good to know

1. Save your Public Key

2. Create the form include

3. Add the pages

Good to know