Basker Docs

Forms

Build forms that visitors can fill in on your site and route responses to your team

A form in Basker is a configurable form that you build inside the editor and embed on a page. When a visitor submits it, Basker can email the response to your team and then show a confirmation message or send the visitor to another page.

Forms are useful for:

  • Contact forms.
  • Mailing-list sign-ups.
  • Event-specific RSVPs and enquiries.
  • Press, hire, or trade enquiries with structured fields.
  • Feedback forms tied to a campaign or programme.

Open Forms under Website in Basker. The screen is subtitled Build contact forms and collect submissions.

Build a form

Set the title and slug

Click CREATE NEW to open the form editor. Fill in the Title (required): this identifies the form inside Basker. The right-hand sidebar has a Form Slug field (required): a URL-friendly identifier like contact-form.

Add fields

The Fields section has an Add Field button. Available field types are text, multi-line text, dropdown, checkbox, number, email, country, state, and a static message field for instructions between inputs.

Each field has:

  • A label: what visitors see next to the input.
  • A name: used internally to identify the field and label its value in submissions.
  • A required option: the field must be filled in for the form to submit.
  • A default value or placeholder, depending on the field type.
  • For dropdowns: the options to choose from.

Set the submit button label

The Submit Button Label field controls what visitors see on the form's submit button. The label is translatable per language.

Configure the confirmation type

The Confirmation Type has two options:

  • Message (default): show an on-page message after the form submits.
  • Redirect: send visitors to a different page after they submit.

Pick one and fill in the corresponding fields underneath.

Set up email notifications

The Emails section sends a notification when the form is submitted. Add the recipients who should be alerted: use comma-separated lists to notify several people at once. Each notification is prepared from the submitted values before those values are removed from Basker's stored submission record.

Save and embed

Click Save. Open the page where you want the form to appear and add a form block, then pick the form you just created. Preview the page to test the form end-to-end before publishing.

Embedding a form

Once a form is set up, embed it using your theme's form block. The same form can be embedded on as many pages as you need. See Building pages with blocks.

Spam protection

Public forms support reCAPTCHA validation. It runs only when you've enabled reCAPTCHA in your site's Google app settings and added both the site key and secret key there; submissions that fail the check are rejected before being recorded. With reCAPTCHA turned off, forms accept submissions without it.

Response privacy

Forms often collect personal information. Basker removes submitted field values from the stored submission record immediately after the form has been processed. The record keeps the field names with a privacy-removal marker, along with submission metadata such as its time and form.

Email notifications are therefore the main route for receiving a complete response. Send a test submission to every recipient before publishing, and use a suitable secure system outside Basker if your team needs to retain or process the response.

Where to go next

On this page