Upgrading from v1

While the changelog (opens new window) is the most comprehensive list of changes, this guide provides high-level overview and organizes changes by category.

Plugin Settings

We've removed enableGatsbyCompatibility as it is no longer required.

Removed Controller

The formie/csrf/* actions have been removed. If you relied on these to refresh the CSRF token for your forms, refer to the docs for the updated controller and code.

Templates

There have been a number of template changes, some which have been inherited from Craft 4 changes.

getFields()

Any references to getFields() should be changed to getCustomFields(). This is inline with Craft 4 element field layout changes.

Form

The following changes have been made to the Form object.

OldWhat to do instead
getFields()getCustomFields()

Page

The following changes have been made to the Page object.

OldWhat to do instead
getFields()getCustomFields()

Row

The following changes have been made to the Row object.

OldWhat to do instead
getFields()getCustomFields()

Submission

The following changes have been made to the Submission object.

OldWhat to do instead
getFields()getCustomFields()

GraphQL

Queries

We have changed the queries used for GraphQL so as not to conflict with other plugins.

OldWhat to do instead
forms(arguments)formieForms(arguments)
form(arguments)formieForm(arguments)
formCount(arguments)formieFormCount(arguments)
submissions(arguments)formieSubmissions(arguments)
submission(arguments)formieSubmission(arguments)
submissionCount(arguments)formieSubmissionCount(arguments)

We have also changed some references to fields which conflict with GraphQL schema requirements.

OldWhat to do instead
FormInterface::fieldsFormInterface::formFields
PageInterface::fieldsPageInterface::pageFields
RowInterface::fieldsRowInterface::rowFields

Example

// Formie v1
{
    form (handle: "contactForm") {
        fields {
            handle
        }

        pages {
            fields {
                handle
            }

            rows {
                fields {
                    handle
                }
            }
        }
    }
}

// Formie v2
{
    formieForm (handle: "contactForm") {
        formFields {
            handle
        }

        pages {
            pageFields {
                handle
            }

            rows {
                rowFields {
                    handle
                }
            }
        }
    }
}

FormSettingsInterface

The following properties have been removed.

OldWhat to do instead
submitActionUrlredirectUrl

The following properties have been removed.

OldWhat to do instead
multiplemulti

Previous ← Configuration Next Forms →

Get started with Formie

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