Revised: 01/27/2026
GOapply Simple Form Builder
Prerequisites
- GOapply Administrator Security Role
- Member of the GOmanager Group
Things to know:
Simple Form Builder will be the default Form Builder for Phases created after August 28, 2025 (the date this feature was implemented).
Phases that were created using the Advanced Form Builder cannot be reverted to the Simple Form Builder. This also applies if you duplicate an Opportunity/Phase; the Phase will always open in the format it was built.
Build a Form Using Simple Form Builder
Step 1: Open Simple Form Builder
As stated above, Simple Form Builder will be the default for any new phases built after August 28, 2025. You can open Simple Form Builder by clicking Launch Application Form Editor from the Form Editor tab of a GOapply Phase.
Simple Form Builder and Request Fields
In the Designer Tab of Form Builder, you can add questions and panels to the form.
On the left side of the screen, you will see questions available to add to the GOapply phase/form. This includes two sections – Unmapped and Request. Questions can be added to the GOapply phase/form by dragging and dropping them onto the form.
The Unmapped section includes questions that are not mapped to any field/record in akoyaGO. These questions cannot be mapped. Unmapped questions capture information needed for the phase, but that does not correspond to a field on Request.
The Request section includes questions mapped to fields in the Request table in akoyaGO. This includes custom fields for your organization. These questions are pre-mapped to the related field in akoyaGO.
Additionally, all Contact and Constituent lookup fields related to the Request (Applicant, Payee, Primary Contact, etc.) can be added as panels to the GOapply phase/form. Panels are also pre-mapped to the related record (i.e., Contact, Constituent) in akoyaGO.
Step 2: Add Questions to the Form
To add questions to the form, you can drag and drop or click the question from the side navigation bar.
- Drag-and-drop lets you place the question wherever you want in the phase.
- Clicking the question will add it to the bottom of the page, and you can drag it to a different place using the arrow pointer.
After you add the question to the form, you will set General Properties for each question from the left side panel:
- Question name: is internal-facing information. This is used to identify the question and becomes particularly important when developing any logic in this phase. This will default to the pre-mapped field's field name if applicable.
- Question title: is external-facing information. This is how the question will be worded in the GOapply UI for the GOapply user. This defaults to the pre-mapped field name if applicable, but can be changed if desired.
- The Question name and Question title may be set to the same thing, or you may choose to set the Question name to an abbreviated version. For example, the Question name might be Requested Amount, while the Question title might be Please provide the amount you are requesting.
- Question Description: appears under the Title on the application, giving applicants more information on how to answer the question.
- Hide from Reviewer: if checked, will hide this question from the PDF that is displayed to reviewers in the GOapply UI
- Visible: turn off to hide the question from the applicant. This setting overrides the Is required setting. This setting is beneficial to use in conjunction with Default Values. Please note that when this property is off, the question will also be hidden from reviewers.
- Read-only: if enabled, applicants will be able to see the question but not enter an answer.
- Required: turn on to make a response required by the GOapply user.
- Show the title and description: turn off to hide the question title and description in the GOapply UI.
For unmapped questions, you will need to choose what type of question you want to insert. Here is a breakdown of the different question types:
- Checkbox: This question type is used for questions where the applicant can select multiple options. This is the only question type that allows multiple items to be checked. Only the selected options are recorded in the PDF. Example: What Social Media Sites do you use?
- Dropdown: This question type is used for multiple-choice questions where the applicant can choose only one option. This question type can be used for questions with many options (such as lists of countries, states, etc.) because it requires the user to click into the question to select an option. Example: Please select the group of people to benefit from this grant.
- Dynamic Matrix: A Dynamic Matrix is an extendable input field that enables respondents to provide multiple answers within a single question in table format. Below is an example of how one might use a dynamic matrix.
- Expression (read-only): This field is best utilized for calculating amounts. Set the expression in the General section of the question properties:
Use curly brackets to access the question values. For example, if you wanted to add two field amounts, your formula would be {question19} + {question20}. For calculated fields that the applicant should not see, you can uncheck “Visible.” It will still calculate if hidden.
- File Upload: upload file. Many details can be specified in the Properties tab, including the maximum file size, accepted file formats, and the preview area. File formats are restricted by a comma-separated list of file extensions, including periods, e.g., .jpg,.pdf,.png. For security, it is important that you specify the file formats allowed for upload to the survey. Each field is limited to a single file.
Accepted file types are = txt, rtf, doc, docx, xls, xlsx, png, jpg, jpeg, gif, csv, ppt, pptx, pdf, mp4
Maximum file size = 20MB
- HTML: This is a rich text editor. Best practice is to type and format your text in the space provided. To make the text editor larger while you are editing, select the button to expand. It is not recommended that you copy and paste text from MS Word or any other text editor in this box, as it will cause issues with how your final PDF is rendered. 'Heading' font types are not supported.
- Image: allows an image to be uploaded or linked into the application. This is not an image upload field for the applicant.
- Long Text: can be used for detailed, multi-line answers. If you want to allow the applicant to format their answers (bold, italicize, underline, etc.), choose the Rich Text Editor question type instead. Character count limits can be placed on Long Text question types.
- Multi-Select Matrix: a type of survey or form question that presents a grid or table structure where respondents can select multiple answers for each row or column combination. Below is an example of how one might use a multi-select matrix.
- Radio Button Group: This question type can be used for multiple-choice questions where the applicant can choose only one option, similar to the Dropdown option above. This question type allows the user to see all choices without having to click a dropdown. This option is also most often used for yes/no questions, or any other boolean (two-choice) questions.
Example: Do you agree to the terms of this grant?
- Rich Text Editor: Long form response. This question type is used for narrative, long answers, such as unmapped essay questions. A text box is presented to the applicant. There are no limits on the input, so the applicant may enter any text, however long. The applicant can also apply formatting with this option.
- Signature: allows applicant input to be directly drawn on screen in a pre-set box or area. This is typically used to obtain a signature; however, it could be used to obtain any hand-drawn input. The box size can be changed by clicking the Properties tab. The pen and background colors can also be modified. The applicant's input is recorded in the PDF in the following formats: JPEG, PNG, or SVG. This file format may be changed in the Properties tab.
- Single-Line Input: single line text. Use for short answers such as dates, email addresses, numbers, phone numbers, texts, URLs, etc. There are no limits on the input, so applicants may enter any text, however long.
- Single-Select Matrix: This is useful when you need to ask respondents to rate statements on the same scale. A good matrix table question example is a Likert scale survey question (also known as a satisfaction scale). Below is an example of how one might use a single-select matrix.
Panels
For questions that will map to lookup fields on the Request table in akoyaGO, you will insert a Panel. For example, if you are asking questions about the Request – Primary Contact or the Request – Applicant Constituent, you will group them in a Panel. The questions within a Panel will map to the record related to the Request (i.e., the Applicant’s constituent record, the Primary Contact’s contact record).
In Simple Form Builder, Panels are denoted by an open square.
Panels will come loaded with at least one field that is marked Is Lookup – the field that identifies which existing record to map to (if applicable).
For example, the Applicant panel displays the Applicant field on the Request, which is linked to the Constituent table. The Applicant panel comes pre-mapped with a required Tax ID field, which is used to identify any existing Constituent records in your database to which the panel will map. If the Tax ID entered by the applicant does not exist in your database, a new Constituent record will be created and set as the Applicant on the associated Request.
Add Questions to a Panel
Once pulled into the form, the panel will have an +Add Question option, click there for a list of questions (related to the panel) to add to the panel.
For example, in the Applicant panel, all question options correspond to fields in the Constituent table. For the Primary Contact panel, the question options will correspond to fields on the Contacts table.
Add Branching Logic
To add logic, navigate to the Logic tab of the form builder.
Click Add New Rule.
Click the Select… box to choose the question this logic begins with.
In the Equals box, choose the answer you’re looking for in the question selected.
Next, click Select action… to choose what happens if the applicant answers the question in that way.
- Show/hide page: Makes the selected page visible. If you want to hide the page, invert the condition.
- Enable/disable page: Makes the selected page editable. If you want to make the page read-only, invert the logic of your condition.
- Show/hide question: Makes the selected question visible. If you want to hide the question, invert the logic of your condition.
- Enable/disable question: Makes the selected question editable. If you want to make the question read-only, invert the logic of your condition.
If this logic applies to more than one answer to the question, choose Add Condition. An additional line will appear. Click Select… to choose a condition.
Continue this for as many conditions as this logic has. When you are finished, click Done. Now, when you navigate to the Logic tab, all of your branching logic rules will be listed.
Preview tab
The Preview tab shows applicants what your phase will look like. Here you can verify that your branching logic works as expected.
JSON Editor tab
This shows the phase in JSON (JavaScript Object Notation) format. This is helpful for reviewing a full phase if you are familiar with JSON. If not, don’t worry, you won’t need to use the JSON Editor tab.
Forms cannot be edited from the JSON editor. The page will be read-only.
