Guides
Custom Download Forms
The custom download form feature enables you to design a form that allows your customers to create and add passes to their wallets for each of your Pass Templates.
Ext ID - This is an optional toggle which can be enabled for one of your form fields to uniquely identify a pass created by the form.
Template field - This corresponds to the field on your pass template that will be populated with user input on your dynamic form.
Label - This is the label that will be displayed on your custom form for a given field.
Validation type - We have a number of pre-configured validation options - Phone, Email, URL - which when selected will apply the relevant validation to the form field, and a custom option which allows you to enter custom regex to be applied to the field.
Custom error message - You can also enter a custom error message to be displayed if the user input doesn’t meet the requirements, which defaults to 
Date Format - Here you can set a specific format in which you would like a user’s input to be displayed on their pass once created. The options are 
Template field - This behaves similarly to input fields, but with an additional option to select none. Instead of mapping the form input to a pass template field, choosing none applies the value as a group tag to the created pass, enabling effective segmentation and filtering of your passes.
Placeholder - This is a customisable text placeholder that appears when no dropdown values have been selected.
Dropdown options - These are the options that will be displayed for this dropdown field. Click “Edit” to create, update, or delete your options.
Here you can configure required and optional query parameters for your pass template fields that can be handled by your form to populate the pass without user input. An example URL would be
Getting Started
This feature is available when creating or editing a Pass Template and must be enabled using the following toggle:
Previewing Your Custom Form
You can preview your form in real time using the preview component while creating or editing a pass template with custom forms enabled. This feature displays the URL, design elements, and form fields for both mobile and desktop browsers.
Designing Your Custom Form
Once you enable the custom download form for your template, you will see several fields that allow you to personalise the form to your needs: Form Name - This is a required field that serves as an identifier for your form. It must be a unique, dash-separated string, as it will be used in the URL when accessing your form once it is live. Header Image - The logo displayed at the top of your form. By default, this will be the logo from the pass template. Favicon Logo - The favicon logo displayed in the browser tab when viewing your form. If not specified, it will default to the icon logo from the pass template. Background Colour - Defines the background colour of your form. Component Fill Colour - Sets the colour of the form components. By default, this will match the pass background colour from the pass template. Font Colour - Determines the colour of the text displayed on your form. By default, this will match the title font colour from the pass template. Button Background Colour - Defines the colour of the button on your form. Button Text Colour - Determines the colour of the text displayed on the button. Button Text - The text displayed on the button.Form fields
These form fields define the structure of your form. Click “Edit” to expand the fields, enabling you to add, remove, reorder, or configure them as needed. When designing a custom form, you can choose between two field types: input and dropdown. Each type includes various sub-fields that can be customised to suit your requirements. By default, the form fields are pre-populated with input fields corresponding to the active fields on your pass template.
Input Fields
Input fields allow users to enter text or numeric information. The template field, label, and validation rules can be customised to suit your requirements.
Ext ID - This is an optional toggle which can be enabled for one of your form fields to uniquely identify a pass created by the form.
Template field - This corresponds to the field on your pass template that will be populated with user input on your dynamic form.
Label - This is the label that will be displayed on your custom form for a given field.
Validation type - We have a number of pre-configured validation options - Phone, Email, URL - which when selected will apply the relevant validation to the form field, and a custom option which allows you to enter custom regex to be applied to the field.
Custom error message - You can also enter a custom error message to be displayed if the user input doesn’t meet the requirements, which defaults to Please enter a valid <form field label>.
For example:
Date Fields
Date fields allow users to enter a date to be applied to their pass with specific date formatting.
Date Format - Here you can set a specific format in which you would like a user’s input to be displayed on their pass once created. The options are dd/mm/yyyy, yyyy/mm/dd, dd/mm/yy, and Month Day, Year.
Dropdown Fields
Dropdown fields provide a list of options for users to select from.
Template field - This behaves similarly to input fields, but with an additional option to select none. Instead of mapping the form input to a pass template field, choosing none applies the value as a group tag to the created pass, enabling effective segmentation and filtering of your passes.
Placeholder - This is a customisable text placeholder that appears when no dropdown values have been selected.
Dropdown options - These are the options that will be displayed for this dropdown field. Click “Edit” to create, update, or delete your options.
Custom Query Parameters
You can also add custom query parameters to your form. This will allow you to pass in additional data to the form which can be used to populate the pass.
Here you can configure required and optional query parameters for your pass template fields that can be handled by your form to populate the pass without user input. An example URL would be https://form.passentry.com/form-name?label1=value1&label2=value2, which would populate the pass fields with the values for label1 and label2 respectively.
It’s important to note that if you create a custom query parameter for a template field that also has a corresponding form field (See Form fields), the user input provided to the form field will take precedence.
You can also pass the optional groupTag or groupTags parameter to your pass form, which will apply the provided value(s) as group tags to the created pass for segmentation purposes, eg https://form.passentry.com/form-name?groupTag=example-group-tag & https://form.passentry.com/form-name?groupTags=example-group-tag1,example-group-tag2.