Skip to main content

Enrollment forms

Enrollment forms are a way to distribute passes to customers who are already in your Actito database. Instead of issuing passes individually through a campaign, an enrollment form generates a public link and a QR code that your customers can use to self-identify and claim their own personalised pass — at any time, from any channel.

A typical use case: you display the QR code in your store. A customer scans it, enters their identifier (e.g. their email address or loyalty card number), and is immediately redirected to a page where they can add their pass to Apple Wallet or Google Wallet.

To access enrollment forms, go to Hub > Wallet > Enrollment Forms.

Enrollment forms module

Creating an enrollment form​

Click on Create an enrollment form to open the creation window.

Create an enrollment form

FieldDescription
Form nameThe internal name of your enrollment form. Only visible to you and your team in the dashboard.
Pass templateThe pass template that will be used to generate the pass when a customer completes the form. The template must have been created and saved beforehand.
TableThe table in which the profile's identifier will be looked up. This can be any table from your data model.
Unique attributeThe attribute used to identify the customer in the selected table (e.g. emailAddress, cardNumber, fidelityNumber). This is the value the profile will be asked to enter in the form.

Create stays disabled until all four fields are set. If the pass template you selected only offers a single table or a single unique attribute, that field is selected for you automatically and shown read-only.

info

The pass template, table and unique attribute cannot be changed once the form is created.

When you click Create, the page builder opens on a default page. Nothing is saved yet — the form, its page and its images are only created once you save from the builder.

Designing the enrollment page​

The page builder lets you design, on a single screen, both pages your customers will see: the Form page where they enter their identifier, and the Confirmation page where they get their pass.

Form page in the builder

Confirmation page in the builder

Toolbar​

Along the top of the builder:

  • The language selector sets which language you are currently editing text in.
  • Undo and redo step back and forward through your changes.
  • The computer / phone toggle previews the page at that device size.
  • Light / Dark switches between the page's two colour variants — shown only if you have turned on a dark mode for the page.
  • Form / Confirmation switches between the two pages.
  • Exit, Save and Save & exit are on the right. Leaving with unsaved changes — by clicking Exit, another link in the app, or closing the tab — asks you to confirm first; Save & exit saves without asking.

On the left, three tabs switch what that panel shows: Modules (the palette), Layers (the page's module tree) and Global styles (colours, shape, languages).

Modules, Layers and Global styles tabs

Adding modules​

On the left, the Modules tab lists the building blocks you can drag onto the page, or click to add after the currently selected module.

Structure

  • Container — groups other modules together
  • Columns — splits the page into side-by-side sections
  • Spacer — adds vertical space
  • Divider — adds a horizontal line

Standard

  • Image — your own picture (banner, illustration, etc.)
  • Text — a text block, which can include bold, italic and links
  • Link button — a button that opens a link

Enrollment

  • Consent — a checkbox the customer must tick before they can submit the form, with its own text. You can add up to one per page; once a page already has one, the consent tile is disabled and shows "Up to one consent".

The logo, the identifier field, the submit button and the Add to Wallet buttons are required on every page, so they are not in the palette and cannot be removed.

Layers​

The Layers tab lists every module on the page. Drag a module by its handle to reorder it — including into a container or a column — and delete it from here. Required modules are locked and cannot be deleted.

Styling the page​

The Global styles tab sets the page's colours, shape and languages.

  • Colours: page background, container, text, secondary text, buttons and links, text on filled buttons, field borders and dividers, and field background — set separately for light mode and, if you turn it on, dark mode. A readability check flags any text that would not have enough contrast with its background for every visitor.
  • Shape: a slider for the container's corner radius, and a choice of square, rounded or pill fields and buttons.
  • Languages: which languages the page speaks, and which one is the default — shown to a visitor whose own language the page does not offer. You can also set the browser tab title for each language.

Content and languages​

Select a text module and edit it in the right-hand panel; the preview updates immediately, for the language, device, page (Form/Confirmation) and appearance (Light/Dark) currently selected in the toolbar. Switch the toolbar's language selector to edit the same text in another language. A text that is missing in one of the page's declared languages is flagged.

Images​

Images you upload (the logo, image modules) must be a PNG or JPEG file of 2 MB or less. Any other format, or a larger file, is refused with a message and nothing is added.

Saving​

Clicking Save checks the page first: a required module that is missing, an image without alternative text, or a link that is not https, blocks the save, and each problem is shown next to the field it concerns. If the server refuses the save instead — for example, because the form name is already used — the builder explains why and keeps your changes so you can fix the issue and try again.

The first save creates the form, its page and its images all in one go, and moves the builder to the form's own URL. Save & exit then returns you to the enrollment forms list with the form's QR code already open.

tip

The builder is fully usable from the keyboard: every module, panel and toolbar control can be reached and used without a mouse, and the shortcuts shown in the undo and redo tooltips work anywhere outside a text field.

Once the enrollment form is saved, Actito automatically generates a QR code and a unique link for that form.

QR Code & Link

You can:

  • Download the QR code as a PNG or SVG file, to print and display in-store, at an event, or on any physical medium.
  • Copy the link, to embed in your communications, app, website, or any digital channel.

Both the QR code and the link point to the same enrollment form and can be used interchangeably.

Client enrollment​

When a customer scans the QR code or clicks the link, they are taken to the page you designed in the builder, asking them to enter the value corresponding to the unique attribute you configured (e.g. their email address). Actito then looks up the matching profile in the selected table. The customer must already exist in your database. If a match is found, a personalised pass is generated based on the linked template.

tip

For customers you already know, you can pre-fill the identifier by adding it to the enrollment link as an identifier parameter. The page then opens with the input field already filled, so the customer only has to confirm and claim their pass instead of typing anything.

This is especially helpful when the customer is already identified, for example logged in on your website: build the link with their known value so they go straight to claiming their pass, for example https://<your-enrollment-link>?identifier=123456.

The page is shown in the language of the link's ?language= parameter; if that parameter is absent or not one of the page's languages, Actito uses the language the visitor last used on the page, then their browser's language. If none of these match a language the page declares, the page's default language is used instead.

The customer is then redirected to the confirmation page, showing two QR codes — one for Apple Wallet and one for Google Wallet — along with the corresponding download buttons. The customer scans the QR code matching their device, or taps the button directly, and the pass is added to their wallet immediately. On a phone, the matching Wallet app opens directly instead.

The enrollment form automatically detects the customer's operating system and presents the appropriate wallet option. Both options are always displayed so the customer can choose.

Managing enrollment forms​

From the Enrollment Forms module, you have an overview of all your enrollment forms, with their name, linked pass template, and template type.

Enrollment form module

Filters​

On the left side of the screen, you can filter the list by:

  • Profile table: show only forms linked to a specific table
  • Pass template: show only forms linked to a specific template
  • Status: Active (the form is live and accepting enrollments) or Finished (the form has been closed)

Actions​

Actions

Select a form in the list to access the following actions:

  • Edit: opens the form in the page builder, where you can change its modules, text, styling and settings. The pass template, table and unique attribute cannot be changed.

    info

    A form created before the page builder existed opens with its former description and input label already placed on the page as text, so you can carry on designing from there.

  • View QR code: opens a modal displaying the QR code and the enrollment link for that form. From here you can:

    • Download the QR code as PNG or SVG
    • Copy the enrollment link
  • More > Finish: closes the enrollment form permanently. The link and QR code will immediately stop working. Make sure you no longer need the form before using this action. For example, remove the QR code from any physical or digital locations where it is still displayed.

info

Once finished, the link and QR code are deactivated and customers who try to access the form will see the following message: Warning message

Was this page helpful?