Settings

settings holds the options that apply to the whole form. This page lists the keys by what they control. The plan column names the lowest plan in which the editor offers the option: Basic is the free plan, followed by Essential, Professional and Enterprise.

General

Key	Type	Default	Description
`name`	string	The name given when the form was created, or “New form”	Name of the form. It is the title of the form page and the name in the list of forms.
`language`	string	Language of the editor	Language of the form: a two-letter ISO 639-1 code such as `en`, `de` or `pl`. It selects the built-in texts of the form. See Languages.
`is_public`	boolean	`true`	`false` closes the form. Respondents see the message “This form is currently unavailable.”

Schedule and limits

Key	Type	Default	Description	Plan
`start_on_date`	string or `null`	`null`	Date and time at which a closed form opens, for example `2026-12-01T09:00:00.000Z`. It has no effect on a form that is already open.	Essential
`close_after_date`	string or `null`	`null`	Date and time after which the form is closed.	Essential
`close_after_limit`	number or `null`	`null`	Number of submitted responses after which the form is closed.	Essential
`response_time_limit`	string or `null`	`null`	Time to fill in the form, in seconds. A countdown runs from the moment the respondent starts. When it ends, the response is submitted as it is.	Essential

A form also closes when the team reaches the monthly response limit of its plan. That limit is not part of the form.

Access

Key	Type	Default	Description	Plan
`cookie_secure`	boolean	`false`	One response per user. After a response is submitted, the same browser sees “You have already submitted a response to this form.” for 30 days.	Essential
`one_response_ip`	boolean	`false`	Used with `cookie_secure`: a submitted response from the same IP address also blocks the form.	Essential
`only_token_access`	boolean	`false`	The form opens only from a personal invitation link. Other visitors see that the form is unavailable.	Essential
`password_protection`	string or `null`	`null`	Password the respondent has to type on the welcome page, up to 50 characters.	Essential
`bot_protection`	boolean	`false`	Runs a bot check before the response is submitted. New form version only.	Essential

Display

Key	Type	Default	Description
`enable_components_numbers`	boolean	`false`	Shows the question number before each title.
`enable_components_required_asterisk`	boolean	`false`	Marks required questions with an asterisk.
`hide_progress_bar`	boolean	`false`	Hides the progress bar and the question counter.
`disable_go_back`	boolean	`false`	Removes the Back button. Respondents cannot return to an earlier question.
`disable_oneclick`	boolean	`false`	By default a question with a single answer moves on as soon as the respondent picks it. `true` keeps the question on screen until they press Next.
`components_alignment`	string	not set	Alignment of all question pages: `left`, `center` or `right`. Without the key, questions are aligned left.
`save_progress`	boolean	`true`	Keeps the answers and the position in the browser, so a reload continues where the respondent stopped. New form version only.
`keyboard_hints`	boolean	`false`	Shows letters next to the answers and “press Enter” next to the buttons. New form version only.
`enable_cookie_consent`	boolean	`false`	Shows a cookie banner. Tracking tags load only for the categories the respondent accepts. New form version only.
`whitelabel_logo`	string or `null`	`null`	File name of your own logo, shown in the form header. Professional plan.

Randomization

Randomization changes the order of pages. A page is one top-level item of components: a question or a group. The options are in the Essential plan.

Key	Type	Description
`randomize`	string or `false`	`false` keeps the order. `all` shuffles every page. `lock_first` and `lock_last` shuffle all but the first or the last page. `lock_custom` shuffles all but the pages listed in `lock_custom_pages`.
`lock_custom_pages`	string[]	`ref` values of the pages that stay in place with `lock_custom`.
`draw_from_pool`	boolean	With randomization on: show only some of the shuffled pages.
`draw_from_pool_number`	number	How many of the shuffled pages to show, at least 2. Pages that stay in place are always shown.

To shuffle the options inside one question, use properties.randomize of that question.

A/B testing

Professional plan.

Key	Type	Description
`enable_ab_testing`	boolean	Assigns each respondent a random version number and stores it in the hidden field `ab_testing`. Logic rules can branch on that field.
`ab_testing_versions`	number	Number of versions, from 2 to 10. The default is 2.

The version is assigned only when the form link does not already carry an ab_testing value.

Tracking

Professional plan. Each value is an identifier of up to 50 letters, digits, hyphens and underscores.

Key	Type	Description
`google_tag_manager`	string or `null`	Your Google tag ID.
`google_analytics`	string or `null`	A Google Analytics ID in the `UA-…` format.
`meta_pixel`	string or `null`	Your Meta Pixel ID.

With enable_cookie_consent on, the Google tags wait for consent to analytics cookies and the Meta Pixel waits for consent to advertising cookies.

Link preview

settings.meta controls how the form link looks when it is shared. Professional plan.

Key	Type	Description
`meta.title`	string	Title of the preview. Without it, the form name is used.
`meta.description`	string	Description of the preview.
`meta.image`	string	File name of the preview image. Own images are PNG or JPG, up to 2 MB.

E-mail notifications

settings.notifications describes the e-mails sent after each response. Essential plan.

Key	Type	Description
`notifications.self.enabled`	boolean	Send an e-mail to the form owner.
`notifications.self.send_to`	string	Recipient addresses, separated by commas. Empty means the owner’s address.
`notifications.self.subject`	string	Subject.
`notifications.self.message`	string	Body.
`notifications.respondent.enabled`	boolean	Send a copy to the respondent, to the e-mail address given in the response.
`notifications.respondent.subject`	string	Subject.
`notifications.respondent.message`	string	Body.

Subjects and bodies accept their own placeholders.

Placeholder	Replaced with
`{{form:title}}`	Name of the form.
`{{form:answers}}`	All questions with their answers.
`{{form:hidden}}`	All hidden fields with their values.
`{{form:variables}}`	All variables with their values.
`{{form:link}}`	Link to the results in Responsly.
`{{component:<id>}}`	The answer to one question, named by the `id` of the question.
`{{hidden:<name>}}`	One hidden field.
`{{variable:<name>}}`	One variable.

Quotas

Key	Type	Description
`quotas_enabled`	boolean	Switches on the response quotas set on choice questions. See Quotas. The feature is enabled per team.

Stored outside the form

These belong to a form but are not part of settings:

What	Where it is described
Colors, font, background	Themes
Translations and the texts of buttons and messages	Languages
Webhooks	Create webhook
The Mobile app channel	Mobile SDK
Custom link, custom domain, invitation links	The Share tab of the form