FormVersions
Returns all versions of a given form, allowing tracking of design or configuration changes over time.
Select
The add-in uses the Klaviyo API to process WHERE clause conditions built with the following columns and operators. Remaining filters are evaluated client-side within the add-in.
- Id supports the operator: =
- CreatedAt supports the operators: >=, >, <=, <
- FormType supports the operators: =, IN
- Status supports the operator: =
- UpdatedAt supports the operators: >=, >, <=, <
- FormId supports the operator: =
For example, the following queries are processed server-side:
SELECT * FROM FormVersions
WHERE Id = 'formversion-id-1'
SELECT * FROM FormVersions
WHERE CreatedAt >= '2025-04-06'
AND Status = 'live'
Columns
| Name | Type | References | Description |
| Id [KEY] | String | The unique identifier for the form version, automatically generated by Klaviyo. | |
| FormId | String |
Forms.Id | The unique identifier of the form associated with this version. Use this value to retrieve or group all versions of a specific form. |
| ABTestVariationName | String | The name assigned to the A/B test (split test) variation for this form version, if applicable. | |
| CreatedAt | Datetime | The date and time when the form version was created, in ISO 8601 format (YYYY-MM-DDTHH:MM:SS.mmmmmm). | |
| FormType | String | Specifies the type of form, such as popup, embedded, or flyout. | |
| Status | String | Indicates the current status of the form version. A status of 'live' means the form is active and visible on the site. | |
| UpdatedAt | Datetime | The date and time when the form version was last updated, in ISO 8601 format (YYYY-MM-DDTHH:MM:SS.mmmmmm). |