Deneb Jekyll documentation

Contact form

Connect the contact form and the footer newsletter form to Formspree or Web3Forms.

Deneb has no server, so the form sends its messages to a form service. It works with Formspree and Web3Forms. Both have a free plan.

The form is in the contact section of the Contact page. It has these fields: name, email, company (optional), budget, message and a consent box.

Demo mode

Out of the box form.provider is demo. The form looks real, but it sends nothing and shows a notice. Switch to a provider before you launch.

Formspree

  1. Make a form at formspree.io and copy the address it gives you.
  2. In _config.yml:
deneb:
  form:
    provider: formspree
    action: the-address-formspree-gave-you

The first message asks you to confirm your email address.

Web3Forms

  1. Get an access key at web3forms.com.
  2. In _config.yml:
deneb:
  form:
    provider: web3forms
    action: the-address-web3forms-gave-you
    access_key: your-access-key

The access_key line is not in the starter file, so add it.

Restart jekyll serve after you edit _config.yml.

What the form sends

The form posts these named fields: name, email, company, budget, message and consent. With Web3Forms it also sends access_key. If provider is formspree or web3forms but action is empty, the form stays in demo mode.

Change the form texts

The labels, the budget choices and the consent sentence are in _data/i18n.yml: form_name, form_email, form_company, form_budget, budget_unsure, budget_1 to budget_4, form_message, form_consent and form_send.

Newsletter form

The small form in the footer is set under newsletter in _config.yml:

deneb:
  newsletter:
    title: Get our monthly notes
    text: One email a month on design and growth. No spam.
    action: https://example.com/your-form-address

It posts an email field to action. Use the form address of your email service. Set newsletter: false to remove it.

Spam

Turn on the spam protection of your form provider, in its own settings. Check your spam folder if messages seem to go missing.

Your details next to the form

The email, phone, address and hours beside the form come from the deneb: block. See Configuration.