1. Forms

Enable forms in the Page builder

For content authors to insert a form into a page inside the Page builder, ensure you have:

  • Access to the Content editor

  • Permission to update presentation configuration items for the site, in particular rendering availability and placeholder settings

Follow these configuration steps:

Verify that the Form rendering is available and allowed

To make Forms available in Page builder, you must ensure the Form rendering is:

  • Available to the site (Available Renderings)

  • Allowed in the target placeholder (Placeholder restrictions, if used)

Note

If placeholder restrictions are configured for a placeholder, they override what is listed under Available Renderings (site-level availability).

Add the form to available site-level renderings

You need to ensure the following Form rendering is available to the site for authoring:

  • Rendering name: Form

  • Component ID: 62DD1639-9F28-4040-8738-C886480B2127

  • Item path: /sitecore/layout/Renderings/Feature/JSS Experience Accelerator/Forms/Form

Add the form to available site-level renderings:

  1. In Content editor, navigate to /sitecore/content/<site>/Presentation/Available Renderings.

  2. Add the Form rendering to the list if it is not already included /sitecore/layout/Renderings/Feature/JSS Experience Accelerator/Forms/Form.

Allow the Form in placeholder restrictions

Placeholder restrictions are typically implemented using placeholder settings items where the Allowed Controls field contains one or more renderings. When restrictions are configured, authors can add the allowed renderings to the placeholder. In the following example, the Form is added to the headless-main placeholder.

Note

Sitecore enforces placeholder restrictions during authoring in the Page builder. If the Form rendering is not allowed for the target placeholder, it will not appear as an option in Page builder for that placeholder even if the Form rendering is present in Available Renderings.

If a Placeholder Settings item exists but Allowed Controls is empty, Sitecore does not restrict the placeholder and the author can add any rendering that is available.

To allow the Form in placeholder restrictions:

  1. In the Content editor, go to your site placeholder settings, for example, /sitecore/content/<site>/Presentation/Placeholder Settings/.../headless-main or /sitecore/content/<site>/Presentation/Placeholder Settings/.../headless-content.

  2. Select Placeholder Settings item for the placeholder (for example, headless-main or headless-content).

  3. In the Data section, in Allowed Controls, add /sitecore/layout/Renderings/Feature/JSS Experience Accelerator/Forms/Form.

    This allows authors to place the Form component into that placeholder.

If you have suggestions for improving this article, let us know!