Forms: integration and implementation guide

In Reason One, Kontent.ai’s partner digital agency, they’ve moved their own website to Kontent.ai. This example will showcase a typical “contact us” form on their site. As one of the requirements, the content and marketing teams wanted to create and add forms to the website without developer support.

How to approach forms in headless CMSs

There’s more than one way to solve this request:

Use a form microservice

Just as Kontent.ai focuses on content management, some solutions focus entirely on form management, for example, Formstack. Forms created on these services can easily be added to a site, either via embedding a script or via their APIs. These dedicated form services handle everything needed (such as form design, rendering, submissions, or notifications). On the other hand, verify how well they work with accessibility and responsitivity of your design.

Code your own form

Another option is to custom code the form needed directly to your website. In this case, the whole form is in your hands, adding extra implementation work, but you can match your exact requirements. Decide between two options:

• Hardcode forms – Forms created directly in the source code will be quicker to implement but won’t give creators typically desired editing powers.
• Include forms in your content model – Create a content model that will contain content types suitable for your situation, giving creators the power but requiring more work.

If you code your own form, consider where the submits will be stored. You will likely need a database table for that. Alternatively, you can send emails to relevant recipients directly on submit for smaller projects or testing purposes without dealing with storage. Think also about the needed workflow and automation expected from the forms. If you’re moving an existing site to Kontent.ai, and you have the UI and forms already developed, then you might find this approach a suitable intermediary step before exploring further investments.

Which solution did ReasonOne choose?

Due to the smaller nature of ReasonOne’s project, they went with the custom implementation.

• They gave their marketing and content team a way to design forms directly in Kontent.ai by preparing a suitable content model.
• They created a component to render the forms (as designed in Kontent.ai).
• They created a serverless function to handle the form submissions, sending the contents via email to relevant recipients.

Modeling forms