Building and publishing a form

A form asks people for something and files the answer where you can use it. This article takes you from a blank page to a published form. Each later step has its own article.

Forms is available on Foldr Cloud now and on appliances from 11.2. Stages, variables and actions, and document-template output are Foldr Cloud now and appliances from 11.3.

What you need

The Create forms permission. Without it there is no Forms tab under Shared by me. Ask your administrator. See Setting up Forms.

Build a form

  1. Go to Shared by me, open the Forms tab and choose New form.
  2. Start blank, or choose Start from a blueprint: Contact us, Vendor intake, Lead capture or Document request. You can change everything in a blueprint.
  3. Choose Add a question and pick a type. Select a question to edit it in the side panel. Set its Question label, Help text and Required.
  4. Drag questions to reorder them, or use Move up and Move down.
  5. Choose Preview to try the form with its real rules. Reset answers starts again. Submit does nothing in the preview.
  6. Open Settings. Its four tabs are Access, Responses, Behaviour and Look & options. A tab shows a warning badge when something in it will stop the form working.
  7. Choose Publish.

The form builder with the question types, the canvas and the settings panel

You can also ask Grace to draft a form from a description. She only makes a private draft. You look it over and publish it yourself.

Draft, publish and unpublish

A new form is a Draft. Publish puts it live. Publishing checks every rule and refuses a form that cannot work. For example, today().subDays(90) is refused, because today() gives text. Write mash.date.today().subDays(90) instead. Publishing also refuses a repeated field key, and a form with a File upload question and no destination folder.

Changes apply to new responses after you publish again. Unpublish takes the form offline and keeps its responses. Archive hides a form you have finished with.

Next steps

If something does not work

  • Publish is refused. The message names the rule or setting. Fix it and publish again.
  • A question type will not go where you drop it. The builder shows Can’t go in this slot. Some types cannot sit inside a panel or columns.

Full reference

← All articles