Skip to main content
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.

​
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 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.

​
Publishing your form

Once you have finished designing your form, your changes will be saved once you save your pass template, and the updates will be immediately visible in real time at the address shown in the preview component. In addition to sharing the form URL with your customers directly, you can also create a QR code that links to your form to be displayed on your website or in a physical location. There are multiple free QR code generators available online, we would recommend opting for a provider that enables scan tracking to allow you to monitor user engagement.

​
FAQ

​
Can I create a form without any fields?

Yes, you can create a form without any fields. With this configuration, a user will be automatically generated a pass upon visiting your form URL. It’s important to ensure you have default values set for the fields on the corresponding pass template, as there will be no user input.

​
Where can I find my form once it’s live?

The URL for your form will be https://form.passentry.com/form-name., you can also find this URL on the form preview component.

​
How can I turn off my form?

You can turn off your form by unchecking the Enable download form toggle in the pass template editor. This will disable the form and prevent users from being able to access it. However, the design will still be saved and can be re-enabled at any time.
⌘I