Mokanata Docs
Forms & links

Build a form

Add questions of every kind, arrange them side by side, and fix what's missing before you publish. Payment questions are coming soon.

The form builder is where you write a form's questions. Every form starts with the three questions Mokanata needs to turn a response into a contact, and you add the rest from a palette of question kinds, from short answers to file uploads. The payment question is coming soon.

  • Who can use it: Owners, admins and members can create and edit forms. Viewers, and any role without Edit forms, can open a form to read its questions and settings and preview it: the builder shows a View only notice and every field is locked. A role without Create forms that opens New form sees Can't create forms with a Back to forms button. See Roles and permissions.
  • Before you start: Nothing.

Start a form

Click New form

On the Forms tab of Forms & Links, click New form (or press N). The builder opens on its Questions tab, with the status Not saved yet.

The new form builder with the Form title and Description fields, the Full name question, and the Add a question palette on the right

Name the form

Type a Form title, the heading respondents see, and an optional Description: what the form is for and how long it takes.

Check the contact questions

Every form asks for Full name, Email and Phone number, so each response can become a contact. They're always required and can't be deleted, and their type is fixed, but you can reword them (for example "Work email" or "WhatsApp number") and add help text. Their cards say Every form asks for this, so it stays required and can't be deleted.

Add questions

Pick a kind from the palette

The Add a question palette lists every kind, grouped into Text, Choice, Date and time and More. Click one to add it at the end, or drag it into place between other questions.

The Add a question palette: Short answer, Paragraph, Email, Phone number, Number, Multiple choice, Checkboxes, Dropdown, Linear scale, Date, Date and time, Time, File upload, Payment and Section heading

Write the question

Each question has a card headed Question N · Kind. Fill in:

  • Question: what you ask, as respondents see it.
  • Type: change the kind here at any time.
  • Help text (optional): a line under the question that helps people answer.
  • The kind's own settings, if it has any (see below).
  • Required: switch it on and the form can't be submitted without an answer.

Question kinds

GroupKindWhat respondents getSettingsMessage when an answer is wrong
TextShort answerA one-line boxNoneAnswer this question. (when required)
TextParagraphA larger box for longer answersNoneAnswer this question.
TextEmailAn email boxNoneEnter an email address, like name@company.com.
TextPhone numberA phone box with a country picker, starting on your workspace's countryNoneEnter a phone number with its country code, like +62 812 3456 7890.
TextNumberA number boxNoneEnter a number, like 12 or 4.5.
ChoiceMultiple choiceRound buttons, one answerOptionsChoose an answer.
ChoiceCheckboxesTick boxes, any number of answersOptionsChoose at least one.
ChoiceDropdownA list to pick one answer fromOptionsChoose an answer.
ChoiceLinear scaleA row of numbered buttonsRange (1 to 5 or 1 to 10) and a label for each endChoose an answer.
Date and timeDateA date pickerNoneAnswer this question.
Date and timeDate and timeA date and time pickerNoneAnswer this question.
Date and timeTimeA time pickerNoneAnswer this question.
MoreFile uploadA Choose a file buttonAllowed files, Largest file, Allow more than one fileAttach a file. (when required), or "name is over N MB. Choose a smaller file."
MorePayment (coming soon)The amount and a Pay buttonAmount, Currency, What it's for, Payment gatewayPay to continue.
MoreSection headingA heading and description that start a new part of the formHeading, DescriptionNone: it isn't a question

See What respondents see for how each one looks on the public form.

Choice questions

For Multiple choice, Checkboxes and Dropdown, type each answer under Options. Press Enter in an option to add the next one, or click Add option. Click × beside an option to remove it (a question keeps at least one).

A Multiple choice question, Which session will you join?, with the options Morning · 09:00 and Afternoon · 14:00 and the Add option button

Linear scale

Pick a Range of 1 to 5 or 1 to 10, and optionally label each end, such as "Not likely" and "Very likely". Respondents see the labels under the first and last number.

A Linear scale question with Range set to 1 to 10, Label for 1 set to Just starting and Label for 10 set to Very confident

File upload

Choose Allowed files: Any file, Images, PDF or Documents (PDF, Word, Excel), and the Largest file: 5, 10 or 25 MB. Switch on Allow more than one file to let people attach several.

A File upload question with Allowed files set to Documents (PDF, Word, Excel), Largest file 10 MB and Allow more than one file off

Payment

Coming soon

Payment questions aren't available yet: they need a payment gateway, and payment gateways are coming soon. The palette says so and doesn't add one. A payment question already on a form is skipped on the public form: its settings say Payments aren't available yet, so the public form skips this question. Respondents see "Payments aren't available on this form yet.", it takes no answer, and it doesn't stop them submitting.

Once available, a payment question will charge respondents before they can submit, with an Amount, a Currency, What it's for and the Payment gateway. A form will take one payment, and it will always be required.

Section headings

A Section heading splits a long form into parts. Give it a Heading (such as "About you") and an optional Description. It always takes the full width, and has no Required switch because it isn't a question.

Arrange questions

Use the question menu

Click ⋯ on a question's card:

ItemWhat it does
Move up, Move downMoves the question one place.
Half width / Full widthPuts the question beside its neighbour, two to a row, or back on a row of its own. Section headings always take the full row.
DuplicateAdds a copy below it. Not offered for payment and contact questions.
Delete questionRemoves it after you confirm. Answers already given to it stop showing in responses once you save. For a section heading the item is Delete section, and the questions under it stay.

The menu of question 4 with Move up, Move down, Half width, Duplicate and Delete question

Or drag

Drag a question by its grip (the dotted handle on the left of its card). Drop it above or below another question to move it, or on the side of another to put the two side by side. While you drag, a Drop here to put it last box appears at the end.

Full name across the full width, with Email and Phone number side by side underneath as half width questions

Collapse the cards

Click Collapse all above the questions to fold every card to one line: its number, kind, wording and Required (or how many things it has to fix). Click Expand all, or one card's heading, to open them again.

The collapsed question list: Full name, Email and Phone number side by side, Which session will you join?, How confident are you selling in chat today?, Your company profile and Workshop ticket

Fix problems before publishing

When you click Publish (or Save changes on a live form) and something would stop a respondent from finishing, the builder shows a red alert listing each problem instead. Click a problem to jump to the field that fixes it; the card or field with the problem is outlined in red.

The alert 2 things to fix before publishing, with Give the form a title and Question 4 needs a title, above the Form title field outlined in red

ProblemFix
Give the form a title.Fill in Form title.
Question N needs a title.Write the question's wording.
Question N needs at least one option.Add an option to the choice question.
Question N has an empty option. Name it or remove it.Fill in or remove the blank option.
Question N needs an amount above zero.Enter the payment's Amount.
Choose the WhatsApp number respondents message, or enter one with its country code.Set the number on the Settings tab (Continue in WhatsApp).
Fix the custom link: …Change the custom link on the Settings tab (Give the form a readable link).

A draft can be saved with unfinished questions, but not with an invalid custom link.

Preview the form

Click the Preview tab to see the form as respondents will, with your unsaved edits. You can fill it in: nothing you enter in the preview is saved, and finishing it shows the confirmation with This was a preview, so nothing was saved.

The Preview tab showing Spring workshop sign-up on graph paper, with Full name, Email and Phone number side by side, the session choice and the 1 to 10 scale

Save your work

  • Publish saves a new form or a draft and starts taking responses. The form then opens on Settings with its link: see Publish and share a form.
  • Save draft, in the ⋯ menu, saves a new form or draft without publishing it. It's greyed out when nothing has changed.
  • On a live form the main button is Save changes. Until you save, the header says Unsaved changes · respondents see the saved version until you save.

If you leave the builder with unsaved edits, Mokanata asks Discard unsaved changes? Click Keep editing to go back, or Discard changes to leave without saving. Switching between the builder's tabs never asks.

Troubleshooting

Next steps

On this page