Prefill default values for Feishu Forms

Help Center

AI Assistant

Help Center AI Assistant is now available

Got questions about Feishu? Use our AI chat to find the answers.

Click and hold to drag

Got It

Try Now

Prefill default values for Feishu Forms

3 min read

I. Intro

In Feishu Forms, you can add parameters to a form link to prefill default values for questions or to track submission sources.

250px|700px|reset

II. Steps

On the Feishu forms, click Publish in the upper-right corner, and then copy the form link.

250px|700px|reset

Add URL parameters to the form link.

Format: [Form sharing link]?prefill_ [Question]=[Prefilled value]

The question after prefill_ must be entered exactly as it is written in the form.

To prefill default values for multiple questions, use an ampersand (&) to connect them. For example: [Form sharing link]?prefill_Progress=In Progress&prefill_Date=2023/04/01

Question types that support default values: Multi-line text, single option, multiple options, rating, NPS, date, person, number.

250px|700px|reset

Default value specifications

Field type	Specifications
Multi-line text, rating, NPS, number	Enter the text or number directly. Rating and NPS default values must be within the range set by the question, otherwise the pre-filled content will not be available. For example: [Form sharing link]?prefill_Number of members=3
Single option and multiple options	Enter the option directly. For multiple options fields, use a comma (,) to separate the options. For example: [Form sharing link]?prefill_Tags=Function,Experience
Person	Enter the full name of a member that is one of your Feishu contacts. (If there are multiple people in the organization with the same name, it can't be prefilled.) For multiple members, use a comma (,) to separate them. (If a field doesn't allow adding multiple members, only the first member will be prefilled.) For example: [Form sharing link]?prefill_Project leader=Kato,Sophia
Date	Separate the year, month, and day with a slash (/): yyyy/mm/dd (for example, 2000/01/01) When the prefill value contains year, month, day, and time, use a space to separate the date and time: yyyy/mm/dd hh:mm (for example, 2000/01/01 00:00)

To prefill default values that contain special characters, refer to the table below to convert them for the link.

Special character	Convert to the following before adding it to the link	Special character	Convert to the following before adding it to the link
Space	%20 or +	(	%28
;	%3B	)	%29
:	%3A	&	%26
[	%5B	$	%24
]	%5D	,	%2C
{	%7B	!	%21
}	%7D	@	%40
#	%23

Review the prefilled default values in the form

After the parameters are added, you can paste the link into any browser to check whether the default values have been entered correctly.

Note: The form link has a limit of 16,000 characters. If this limit is exceeded, the default values won't appear in the form.

To share the form using a QR code, open the form sharing link with the pre-filled value parameters in a browser and click Share in the upper-right corner to get the QR code.

250px|700px|reset

Hide default value questions

To hide a question with default values from the form, add &hide_[Question]=1 to the form link. For example, to hide the project manager question, set the form link to: [Form sharing link]?prefill_project leader=Kato&hide_project leader=1.

You can use this method to track the source of responses:

For example, when collecting feedback about an event, you may want to analyze which channels the users are coming from.

Steps:

Add a question to the form: Source platform.

Click Publish, set who can fill out the form, and copy the sharing link.

Add a parameter to the form link. If the link comes from Feishu: [Form sharing link]?prefill_source platform=Feishu&hide_source platform=1.

Share these links on their respective platforms. The default value helps you track where the form was submitted from.

III. FAQs

Why is the member's name that I prefilled invalid?

There are three likely reasons:

The member's name is the same as someone else in the organization.

The member is from outside of the organization and isn't your Feishu contact.

You enter the name incorrectly.

Can everyone filling out the form see the default values?

Yes. To hide questions from the form, add the parameter &hide_[Question]=1 to the question in the form link. See Part III: Hide default value questions above for more information.

How do I add special characters to default values?

Refer to the table below to convert special characters to be used in the link.

Special character	Format for link	Special character	Format for link
Space	%20 or +	(	%28
;	%3B	)	%29
:	%3A	&	%26
[	%5B	$	%24
]	%5D	,	%2C
{	%7B	!	%21
}	%7D	@	%40

Will the default values be affected if I change the question in the form?

Yes, it will make the default values invalid.

Why did a question I set as hidden still appear in the form?

A possible reason is that the field is a required field and the default value you've prefilled is invalid. As a result, the field is considered empty and must be filled in.

Prefill default values for Feishu Forms

默认标题