Rendering Forms

Showing the form in your templates is the first step in getting Formie's forms working with your site. Rendering an entire form will include all pages, rows, columns, fields, buttons, captchas and more. Combined with the Form Templates, it should be the only Twig code you need to get forms showing on your site.

The easiest way to output your form is to use the handle of a form:

{{ craft.formie.renderForm('contactForm') }}

You can optionally provide a Form object in the same way.

{% set form = craft.formie.forms({ handle: 'contactForm' }).one() %}

{{ craft.formie.renderForm(form) }}

If you are using custom templates, you can also pass in a number of options to the rendering function. For help on how these options should be structured, refer to the Rendering Options.

{% set options = {
    someOption: 'someValue',
} %}

{{ craft.formie.renderForm('contactForm', options) }}

Override Form Attributes and Classes #

You can use the rendering options to override any HTML attributes, data attributes and classes on the <form> element.

{% set options = {
    formClasses: [
        'my-custom-class',
    ],
    formDataAttributes: {
        'new-attribute': 'some-value',
    },
    formAttributes: {
        'title': 'Some Title',
    },
} %}

{{ craft.formie.renderForm('contactForm', options) }}

The above would produce:

<form class="fui-form fui-labels-above-input my-custom-class" data-new-attribute="some-value" title="Some Title">
    ...

Override Form Settings #

You can also dynamically override any settings for the form

{% set form = craft.formie.forms.handle('contactForm').one() %}

{% do form.setSettings({
    submitActionUrl: 'https://google.com',
}) %}

{{ craft.formie.renderForm(form, options) }}

The above would override the redirect URL for the form, regardless of what is defined in the form's settings. See the Form Settings docs for a full list of available settings to override.

For more fine-grained control over rendering of a form, see Rendering Pages and Rendering Fields

Get started with Formie

Available for Craft 3. Get it from the plugin store.