Skip to main content
Use custom pass issuance forms when you want customers to create and download passes themselves, for example during onboarding, promotions, registrations or in-store sign-ups, without building a custom integration.

​
Getting started

This feature is available when creating or editing a pass template. Enable it with 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 pass issuance 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 PassEntry uses it in the URL of your live form. Header Image - The logo displayed at the top of your form. By default, this is the logo from the pass template. Favicon Logo - The favicon logo displayed in the browser tab when viewing your form. If not specified, it defaults 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 matches the pass background colour from the pass template. Font Colour - Determines the colour of the text displayed on your form. By default, this matches 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 user input on your form populates. Label - This is the label displayed on your custom form for a given field. Validation type - Choose from the pre-configured validation options (Phone, Email, URL), which apply the relevant validation to the form field. A custom option lets you enter custom regex to apply to the field. Custom error message - You can also enter a custom error message that appears if the user input doesn’t meet the requirements. It 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 - Set the format in which a user’s input appears 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 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 lets you pass additional data to the form 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. 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 takes precedence. You can also pass the optional groupTag or groupTags parameter to your pass form. PassEntry applies the provided values as group tags to the created pass for segmentation, for example https://form.passentry.com/form-name?groupTag=example-group-tag or https://form.passentry.com/form-name?groupTags=example-group-tag1,example-group-tag2.

​
Publishing your form

Once you have finished designing your form, PassEntry saves your changes when you save your pass template. The updates are immediately visible 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 display on your website or in a physical location. Multiple free QR code generators are available online. We recommend a provider that enables scan tracking so you can monitor user engagement.

​
FAQ

​
Can I create a form without any fields?

Yes, you can create a form without any fields. With this configuration, PassEntry automatically generates a pass when a user visits your form URL. Make sure you set default values for the fields on the corresponding pass template, as there is no user input.

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

The URL for your form is https://form.passentry.com/form-name. You can also find and copy this URL from the form preview component in the pass template editor.

​
How can I turn off my form?

You can turn off your form by unchecking the Enable pass issuance form toggle in the pass template editor. This disables public access to the form while keeping its design saved, so you can re-enable it at any time.