Overriding Settings

Override settings in a template when the saved form should stay the same, but one render needs slightly different behavior.

This works by loading the form, changing the setting on the form object, then rendering that form object. It can be useful for template-specific redirects, field labels, placeholders, visibility, or dynamic option lists.

Form Settings

Use setSettings() when the setting belongs to the form itself.

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

{% do form.setSettings({
    redirectUrl: '/thanks',
}) %}

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

Keep these overrides deliberate. If the setting should always apply to the form, it is usually better to save it in the form builder.

Field Settings

Use setFieldSettings() when the change belongs to a field.

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

{% do form.setFieldSettings('firstName', {
    label: 'Preferred name',
    placeholder: 'Enter your preferred name',
}) %}

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

For option fields such as Dropdown, Radio and Checkboxes, you can override the available options before rendering.

{% do form.setFieldSettings('department', {
    options: [
        { label: 'Support', value: 'support', default: false },
        { label: 'Billing', value: 'billing', default: false },
        { label: 'Sales', value: 'sales', default: false },
    ],
}) %}

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

For nested fields inside Group or Repeater fields, include the parent field handle so Formie knows which nested field you mean.

{% do form.setFieldSettings('contactDetails.firstName', {
    label: 'Preferred name',
}) %}