Users with submission permission use the published submission form to start a request. For a project approval, the form might capture a project name, owner, dates, and a plan with several work items. Open the approval form in the application, select Edit in Designer, and use the form selector to open its submission form. Overview of the approval form designer
Design the form layout
Put the project details first, the project plan next, and the submission actions where applicants can find them.
Change the background color
In the controls panel, select Page. Choose a background color or image in the page settings. Preview the form to check that text and input fields are easy to read.
Change the content area settings
In Page → Content area, adjust the content width, background, and padding. Check both the content area and the page background when previewing your changes.
Add controls to the form
In Controls, drag the controls you need onto the canvas. Select a control to edit its properties or drag it to rearrange the page.
Default controls
Action panel provides Save as draft and Submit on a blank submission form. Choose left, center, or right alignment for the buttons. Action Panel
Workflow history shows workflow activity after submission. Workflow History
You can move either control. To restore one you removed, drag it back from Controls.
Pro Tip:
You can add more than one Action panel or Workflow history control. On a long form, place an Action panel at the top and another at the bottom so users can submit from either location.
Add header and/or footer
Drag a Title control from General to the top of the form. Enter a title such as Project Approval Form, then set its size and alignment. Add a short instruction or divider below the title, or place a help link in the footer.
Add form field controls
Add a Text Box for the project name. Adding a field control creates a workflow variable that stores the value entered in the form.
In the control properties, open Content → Basic → Associated Variable and select Edit. For this example, set Field ID to
field_projectnameand Field Name to Project Name. You can also find and edit both in the toolbar's Variables list.Turn on Sync Label when you want the field title to match the variable name. Check the displayed title after closing the dialog.
Note
You can edit the visible Title independently. Changing the Title leaves the variable's Field Name and Field ID unchanged.
Add a Dropdown for Category, a User control for Project Owner, and Date Picker controls for Start Date and End Date. Set defaults and required fields where the control offers those options. Before renaming an existing Field ID, review any workflow, task form, or report that uses the variable. Form controls and associated variables
Display controls with multiple columns
Keep Project Name on a full row. Place related fields such as Start Date and End Date side by side where space allows.
1. Set custom width of each control
A new control typically uses the full row. Select the control, open Advanced, and set Width to Custom. Enter a pixel value or a percentage of its container. Preview the result on a narrow screen to check labels and input values.
2. Use Grid control to add multiple columns
Add a Grid below Project Name. In its Appearance settings, use + next to Columns, then drag Category, Project Owner, and the date controls into the grid. Use the caption or title setting to hide the grid heading if needed. A Section groups controls into columns, a Container controls direction and alignment, and Tab or Toggle groups split longer forms into parts. Grid
Add multiple items with Sub List
A Sub List stores multiple detail rows in the same approval request. Each row can have its own field values.
When to use this field
Use a Sub List when the main information is entered once and the details repeat. For a purchase order, enter the order and vendor once, then add a row per device. In a project approval, enter the project details once and use the Sub List for the work items.
Add the Sub List control to your form
Drag a Sub List onto the form. Set its title to Project Plan, its variable ID to
field_projectplan, and its variable name to Project Plan.In List Content → Fields, open Settings and select + Add Field. Add the three fields in the table below.
Select the checkboxes in the first column for the fields you want to display, then choose OK. Expand a field to adjust Control Type or open Control Properties → Settings.
Field ID | Field Name | Type |
field_workitem | Work Item | Text |
field_startdate | Start Date | Date/Time |
field_enddate | End Date | Date/Time |
Add two test work items and check that their dates and values stay on the correct rows. SubList (Approval form only)
Save and Preview
Select Save in the designer toolbar to store your changes.
Select Preview at the bottom of the controls panel. Check defaults, required fields, and the Sub List. If you added conditional display or validation, preview cases that meet the condition and cases that do not.
When testing the complete process, publish the approval form in a test application. Sign in as a test user with submission permission, save and reopen a draft, then submit it. Check the resulting task and the values displayed there. Publish your business process
Customize layout for multiple device
Use the desktop, tablet, and phone icons in the designer toolbar to switch views. Change device-specific properties only where the property shows a device icon, such as title size, alignment, or padding. On the phone layout, check that work-item inputs, validation messages, and Submit are visible and usable.

