Do you already know your respondent’s name, email, or other information? Use hidden fields in your Form so respondents don't have to fill out this information.
Mark any Email, Text, URL, Dropdown, Priority, or Number Custom Field as hidden on a Form, and they will be captured through your unique URL or embed code.
Feature availability and limits vary by plan and user role. Learn more.
Our updated Form view is currently in beta. It is being released slowly to all Workspaces.
Set a field as hidden
To set a field as hidden in Form view:
-
Open the Form.
-
Click the Custom Field-based question to edit it.
-
In the upper-right of the field, click the hide icon.
-
Hidden fields are added to your shareable link or embed code.
Form URL structure
You'll need to append a valid value to the end of a Form's public URL to fill out hidden Custom Fields. Otherwise, Forms will fail to submit the value.
The URL uses the following format (without the + symbols):
Public Form URL
+ ?
+ field label
+ field value
For example:
https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT?Source=ClickUp%20Form
In the above example, this Form view includes a Dropdown Custom Field called Intake Source, which is labeled Source on the Form. ClickUp Form is one of the Dropdown Custom Field values.
Multiple Custom Fields
You can use two or more hidden Custom Fields. The URL uses the following format (without the + symbols):
Public Form URL
+ ?
+ field label
+ field value
+ &
+ field 2 label
+ field 2 value
For example:
https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT?Source=ClickUp%20Form&Priority=3
In the above example, this Form automatically sets the Source Custom Field to ClickUp Form and sets the Priority of the task to Normal.
Copy a Form link with hidden fields
When you copy a Form link, you'll see all hidden fields added to the end of the Form's URL automatically.
Prior to sharing or pasting the URL into the search bar, replace the xxxxx placeholder text with a valid value.
Field name and values
When a field name or value includes spaces, use %20 between each word.
For example ClickUp%20Form
Special characters in either the field label or values are not supported.
Add a line break
To add a line break to your Form, add %0D%0A
to the URL.
For example:https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT?Details=ClickUp%20Form%0D%0AExternal%20Submission
In the above example, the Text area (Long text) Custom Field called Details is set on tasks with the following value:
ClickUp Form
External Submission
Get the public URL
- Open the Form.
- In the upper-right corner, click Copy link to copy the public URL to your clipboard.
- Replace the xxxxx placeholder with a valid value.
- Open the Form.
- In the upper-right corner, click the expand icon next to Copy link.
- Click Copy code to copy the code to your clipboard.
- Edit the src tag of your embed code to include the field label and value.
Example snippet of a Form view embed code:
<iframe class="clickup-embed clickup-dynamic-height" src="https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT?Source=ClickUp%20Form
" onwheel="" width="100%" height="100%" style="background: transparent; border: 1px solid #ccc;"></iframe><script async src="https://app-cdn.clickup.com/assets/js/forms-embed/v1.js"></script>
Add values to the Form URL
Custom Fields that aren't hidden can be prefilled. Field labels and values are case-sensitive. To add multiple prefilled Custom Fields, separate them with an &
.
https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT?
Request%20Source=xxxxx
Below are more examples of Form view URLs with hidden field labels and values.
Email Custom Fields
Add a complete email address to a hidden Email Custom Field. For example:
https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT
?email=test@gmail.com
Date Custom Fields
For Date Custom Fields, enter your date in unix timestamp format. The below example is Tuesday, January 21, 2020 at 18:12:42 GMT+0000.
https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT
?Date=1579630362234
Phone Custom Fields
Before entering a phone number, the area code must be added with a space following it.
Below is an example of a U.S. phone number:
Phone%20Custom%20Field=%2B1%20
Dropdown Custom Fields
Only valid Dropdown options can be included for Dropdown Custom Fields.
For example:
https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT?Source=ClickUp%20Form
In the above example, the Form view includes a Dropdown Custom Field called Intake Source, which is labeled Source on the Form. ClickUp Form is one of the values in the Dropdown Custom Field.
Priority field
The task priority can be set using the following values:
- 1 = urgent
- 2 = high
- 3 = normal
- 4 = low
For example:
https://forms.clickup.com/f/ad-4679/NN9MMFH6QOKWVJUXUT?Priority=3