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:

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.

​
Finishing Touches

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.

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

​
How many group tags can I add to a pass?

You can currently only add one group tag to a pass, so when designing your form you’re restricted to only one dropdown field with the none template field.

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

Was this page helpful?