Add a section break to a custom form with the legacy form builder
You can group the custom fields and widgets in a custom form into sections with headings. This is useful for presenting an organized experience to users who will fill out the form. Also, if you need to limit access to certain custom fields and widgets to certain users, you can place them in a section and then grant access to the section to only those users.
For example, if you need to track sensitive information that only system administrators should be able to view or edit, you can create a section break with Admin Only permissions and place the sensitive fields in that section.
The access settings you select for a section are directly tied to the permissions users have on the Workfront object where the custom form is attached. You can hide or show a section based on whether the user has access to view, contribute to, or manage that object. Or you can set a section to Admin Only so that only users with a system administrator access level can access it.
For information about permissions on objects, see Overview of sharing permissions on objects.
For information about custom fields and widgets in custom forms, see Add a custom field to a custom form and Add or edit an asset widget in a custom form.
Access requirements
You must have the following to perform the steps in this article:
For more detail about the information in this table, see Access requirements in Workfront documentation.
Create and configure access for a section in a custom form
-
Begin creating or editing a custom form, as described in Create or edit a custom form.
-
Add custom fields and widgets to the form, as described in Add a custom field to a custom form and Add or edit an asset widget in a custom form.
-
While still creating or editing the custom form, on the Add a field tab, click Section Break.
-
On the Field Settings tab, configure the options you want for the section:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Label (Required) Type a descriptive label to display above the section. You can change the label at any time.
IMPORTANT: Avoid using special characters in this label. They don't display correctly in reports.
Description Type text if you want to explain to users what the section is for. This displays below the section's label on the custom form. Add Logic Use display logic to specify whether the section should display on the form, based on selections users make in multi-choice custom fields when they fill out the form.
NOTE: If all of the individual fields under a section break have display logic applied to them and they are all hidden as a result of the logic, the entire section will be hidden on the custom form. This will happen even if display logic is not applied to the section break.
For more information, see Add display logic and skip logic to a custom form.
Grant access Select the permissions that users need on an object where the custom form is attached in order to view this section and edit its field values.
The following permissions are available under Users with this access to the object can view field values:
-
View: View permissions to the object
-
Limited Edit: (Available only if the object is a project, task, issue, or user):
Allows users to contribute to the object if it's a project, task, or issue.
Allows users to edit the profile or own the profile permission to the object if it's a user.
-
Edit: Manage permissions to the object
-
Admin only: System Administrator access level
The following permissions are available under Users with this access to the object can edit field values:
-
Limited Edit: (Available only if the object is a project, task, issue, or user):
If the object a project, task, or issue, this permission allows users to contribute to the object
If the object is a user, this permission allows users to edit the profile or own the profile permission to the object.
-
Edit: Manage permissions to the object
-
Admin only: System Administrator access level
For information about permissions on objects, see Overview of sharing permissions on objects.
NOTE:
-
Users without the permissions you specify here can't see the custom fields and widgets in the section.
This is also true if you display the fields' values in reports or use them in calculated fields in text mode reporting.
-
Associating multiple object types with your form can change the viewing and editing permissions that are available in these steps. For more information, see How multiple object types can affect section break permissions in a custom form in this article.
-
-
Drag or add at least one custom field or widget to the new section.
This is required before you save the section.
-
Click Done.
note tip TIP You can click Apply at any point while you are creating a custom form to save your changes and keep the form open. -
If you want to continue building your custom form in other ways, continue on to one of the following articles:
How multiple object types can affect section break permissions how-multiple-object-types-can-affect-section-break-permissions-in-a-custom-form
The Limited Edit permission for custom form section breaks is available for only the Project, Task, Issue, and User object types.
In a custom form with a section break configured with the Limited Edit permission, if you add one of the other object types to the form (Portfolio, Program, Document, Company, Billing Record, Iteration, Expense, or Group), you will be prompted to switch to the Edit permission, which is compatible with both that object type and the existing object types on the form.