Edit or disconnect forms
UpdatedHow it works
You can edit a form at any time to add, remove, or re-map form fields. But changing form fields does not affect form submissions you’ve already received. If you want to keep attributesA key-value pair that you associate with a person or an object—like a person’s name, the date they were created in your workspace, or a company’s billing date etc. Use attributes to target people and personalize messages. Attributes are analogous to traits in Data Pipelines. values consistent, you might need to run a campaign to update attributes.
Edit a form
You can edit your form to add fields, re-map fields to attributes, or turn off fields you no longer want to capture. Your changes only reflect new respondents. Changing form fields doesn’t change attributes on people who already filled out your form.
If you move a form to a new page, you do not need to edit or re-scan your form. You simply need to make sure that the page you move the form to has the custom forms JavaScript snippet.
- Go to Data & Integrations > Integrations and select Forms.
- Select the form you want to edit and click Edit.
- Add, remove, or re-map form fields.
- Enable/disable fields: Check and un-check fields to enable and disable them. You cannot disable fields when you use the
/forms
API or send forms using theaction
attribute. - Add fields: If your form uses the custom forms JavaScript snippet, click Re-scan to update the fields on your form. If your form integrates directly with our API, click Add Field.
- Edit field names: Change the names of attributes you want to map form fields to. If integrated with the
/forms
API, you can also change the name of the form field that you want to map.
- Enable/disable fields: Check and un-check fields to enable and disable them. You cannot disable fields when you use the
- Click Save.
You cannot disable fields when you use the /forms
api or an action attribute
While you can map form fields to attributes in our UI, you cannot disable fields for forms sent to our API or using the action
attribute. If you send data
to the /forms
API, we’ll apply it to the person represented in the request.
Disconnect a form
Disconnecting a form prevents Customer.io from collecting form submissions and identifying people who fill out your form. You can reconnect the form later, if you want to stop collecting submissions temporarily.
- Go to Data & Integrations > Integrations > Forms.
- Click and then click Disconnect.
- Confirm that you want to disconnect the form.
Disconnected forms still appear in the forms list. You can find all your disconnected forms by selecting the Disconnected status.

