Manage Barcode

Change your project’s barcode format and edit its values.

View as Markdown

The following steps set the barcode format and default values for the passes in a project. To add fallback barcodes for Apple Wallet passes, see Configure fallback barcodes. Templates inherit the project’s barcode format and can override it with the API.

  1. Go to Settings, then Barcode.

  2. Select Edit Barcode and make your changes:

    • Barcode Format — Select a format or No Barcode. See Barcode Types for the formats you can select in the dashboard and the formats available only through the API.

    • Encoded Barcode Value — This is the default barcode value. It applies to passes without a barcode value set through the API or an Adaptive LinkA vendor-agnostic, shortened mobile wallet pass link that supports templates for both Google Wallet and Apple Wallet. When a user taps the link, Airship determines the user’s platform and generates the right pass for that platform.. Leave blank if you do not want to add a default value.

      Note

      • If barcodes should be the same for every pass, set the default barcode value here.
      • If barcodes should be dynamic, differing for each pass, you must set barcode values in the header object in the API.

    • Barcode Text — This is the human-readable text shown below the barcode graphic on the pass. On gift card passes, it serves as the visible card number.

      By default, Display the barcode value as the barcode text is enabled, so the barcode value appears as this text. For example, a barcode value of A1234567 appears as A1234567 below the barcode. To use a different string, disable the option and enter a value.

      Note

      Display the barcode value as the barcode text applies only when the barcode value is set through the ?barcode= query parameter on an Adaptive Link, for example ?barcode=A1234567. It has no effect on barcode values set through the API or an Adaptive Link payload object. To control the barcode text in those cases, set barcodeAltText on the pass.

    • Encoding — The default standard is ISO 8859-1. You can enter a different value if your scanning infrastructure supports an alternative.

  3. Select Save.