Docs
Agoo Forms

Building a form

The Agoo Forms builder, with its 34 kinds of question, starter templates made for Ghana, pages, endings, who answers and when a form closes, plus preview, publishing, versions and the keyboard.

Early access· FFor owners, admins and builders

Agoo is in early access. This page describes the feature as it ships to early-access organisations; screens are illustrative.

The builder has five tabs: Build, Logic, Endings, Settings and Share, and Responses once people answer. It works with a mouse, a finger or the keyboard, on a computer, a tablet or a phone (where the palette and inspector open as sheets).

Dragging a Digital address question onto a page, then setting it up in the inspector.Illustrative screen · animated

Start from a template

New form offers Describe it to Agoo AI (a draft from your description, to check before it's made: see AI drafts), a blank form or a template made for Ghana, each a complete form with its questions, logic and endings, ready to change: event registration, meeting interest, volunteer sign-up, service request, training feedback, a simple application, supplier enquiry, internal suggestions, church membership, school admission enquiry, customer feedback, clinic registration and youth camp registration. A template that uses Forms Plus features says so, and the builder marks each one, so you can take it out or move up a level. Browse them at agooforms.com/templates.

Questions and pages

  • Add a question: drag it from the palette onto a page, or click it (or press A) to add it after the question you've chosen.
  • Move it: drag it by its handle, within a page or to another one; or press Space on the handle, move with the arrow keys and press Space again. Every move is announced to screen readers.
  • Set it up in the inspector: the words, help text, Must be answered, lengths and limits, options (drag to reorder, or Paste a list), and its privacy (see Privacy and retention).
  • Pages: add, name, move and delete pages. Respondents see one page at a time, or one question a screen if you choose it in Settings.

Kinds of question

GroupKinds
Text and contactShort text, Long text, Email, Phone, Web address
Numbers and timeNumber, Amount (cedis and pesewas), Date, Time, Date and time
ChoicesSingle choice, Multiple choice, Dropdown, Yes or no, Consent, Tags
ScalesStars, Faces, 0 to 10, How easy
GhanaGhana Card, Digital address, Region and district
MoreStatement, Section, Signature, Matrix, Ranking, Hidden, Calculated, File upload, Photo, Payment
OrganisationsStaff member (in an organisation's workspace, Forms Team)

File upload and Photo take files, each checked for viruses before anyone can open it: see File uploads. Payment (paid with Paystack) arrives with payments; until then the palette shows it with when it arrives, and it can't be added yet.

Signature, Ghana Card, Matrix, Ranking, Hidden and Calculated questions come with Forms Plus; the palette marks them. There is no password question, and there never will be.

Ghana's own

  • Phone: Ghana first. People can type 024 123 4567, +233 24 123 4567 or 0244…, and the number is checked against Ghana's numbering plan, kept up to date from the same numbering data as Agoo's own sign-in. Choose Mobile numbers only to refuse landlines, and allow other countries in the question's settings (their numbers are checked against their own country's plan).
  • Ghana Card: GHA-123456789-0, checked for its form, then sealed as it arrives. It's always sensitive and masked: it never appears in summaries, emails, receipts or exports (they show GHA-•••••••89-0), and only people allowed to see sensitive answers can reveal it on one response, each time recorded. See Privacy and retention. Ask for the number, never a photo, scan or copy of the card: L.I. 2523 forbids relying on one to check who someone is, and Agoo Forms' acceptable use policy doesn't allow it. The question records a number; it doesn't verify anyone.
  • Digital address: a GhanaPost GPS address such as GA-183-8164, checked for its form.
  • Region and district: all 16 regions, then the district, from Agoo's own list of Ghana's places.
  • Amount: cedis and pesewas, shown as GH₵1,234.50.

Endings and settings

  • Endings: what people see after sending: a heading, words and, if you like, an https address to go on to. Logic can choose the ending (Forms Plus).
  • Settings: the title and words; who's answering; a progress bar; a page at a time or one question a screen.

Who's answering

ChoiceWhat people doLevel
Nobody's nameAnswer without a name. The form says plainly what you see.Every level
A name if they likeGive their name if they want; nothing checks it.Every level
A checked emailConfirm their email with a six-digit code before they start.Forms Plus, Team

With a checked email you can also turn on:

  • One response a person: each person sends the form once. Someone who has already answered is told when they confirm their email, with their reference, so nobody fills it in for nothing.
  • Email people a copy of their answers: a receipt to their confirmed address with their reference. Sensitive answers are never in it.

The confirmed address shows with each response and in exports. Asking people to sign in with an Agoo account comes later.

When it takes responses

Settings → Taking responses changes at once, without publishing:

  • Open for responses: close a form by hand, and open it again, on every level.
  • Close on a date (Accra time) or after a number of responses (Forms Plus): the form shows when it closes, and says it's closed before anyone types once it is.
  • What a closed form says: your own words, such as "All places are taken. Thank you!"

People already typing when a form closes keep their answers on their phone. Every change is in your workspace's activity.

Checks, preview and publishing

The builder checks the form as you go, and marks each problem on its question, rule, ending or setting; the tabs count what's left. Preview shows the form exactly as respondents will see it, on a phone or a computer, with its logic working. Nothing sent in a preview is kept.

Publish makes a new version. Published versions never change: people halfway through the previous version can still send it for a day, and responses remember the version they answered. More → Versions lists every version with who published it and when; open one to read it, or Restore as draft.

Agoo Forms checks each version as it's published. Most forms open at once. One that seems to ask for passwords, PINs, one-time codes or card details, or that uses a bank's, a network's or a government body's name when your workspace isn't verified as them, says "We're checking this form, usually within a few hours" and takes no responses until a person on Agoo's safety team has looked. A new workspace can publish only a few forms on its first day. See Safety, holds and appeals.

Saving and working together

Your draft is kept on your computer as you type and saved to your account every few seconds. If someone else in the workspace saved a newer draft, the builder keeps both and asks: Keep mine or Take theirs.

KeysDoes
⌘Z and ⇧⌘Z (Ctrl on Windows)Undo and redo
⌘DCopy the question
⌥↑ and ⌥↓Move it, across pages too
AAdd a question
PPreview
?List every shortcut

On this page