Getting started

Getting started

The goal of the first session: build a contact form, embed it on a page, and confirm submissions reach the entries inbox and your email.

1. Create a form

1. Open OForms -> Forms -> Add New.
2. Set a name (internal, not shown to visitors).
3. Drag in fields from the field palette. For a contact form you need: Text (name), Email (email), Textarea (message).
4. For each field, set the name attribute. This becomes the merge tag in notifications and the key in the entry JSON.

2. Configure success behaviour

Under Settings -> Success Action:

• Show message (default): renders the Success Message HTML in place of the form.
• Redirect: sends the visitor to Redirect URL after submit.
• Reload: refreshes the page.

Leave Store entries on. Otherwise submissions are emailed but not saved.

3. Add an email notification

Notifications tab -> Admin Notification:

• To: your address (comma-separated for multiple).
• Subject: New submission: {{form_title}}.
• Body: {{all_fields}} renders a table of every field label and value.
• Reply-To: {{email}} so you can reply directly to the submitter.

Optionally enable Autoresponder to confirm receipt to the submitter.

4. Embed the form

Two options:

• Block editor: insert the OForms - Embed Form block, pick the form from the dropdown.
• Shortcode: [oforms id="5"] where 5 is your form ID.

The form renders server-side. JavaScript only loads when interactions start (field validation, conditional logic).

5. Verify

1. Visit the page in an incognito window and submit a test entry.
2. Open OForms -> Entries. The submission should appear with status new.
3. Check your email. If no email arrives, check the OMailer log (if OMailer is installed) or your site's mail provider.

Next steps: enable Honeypot CAPTCHA under Form Settings, add conditional logic to show/hide fields, configure a workflow action to subscribe submitters to an OMailer list.