Provisionee Barcode Specification

Barcode development tools
1D Barcode requirements
2D Barcode requirements

Frustration-Free Setup (FFS) technology relies on your device's package barcode to identify a specific device. Amazon scans your device's package barcode during order fulfillment and pre-registers the device with the Amazon customer's account. Pre-registration enables FFS to authenticate device ownership and gives the customer's account and provisioners control over the new device.

You can utilize one-dimensional (1D) or two-dimensional (2D) barcode for device identification. 1D barcode is a recommended approach.

Barcode development tools

The following tools are available to help with barcode development:

Code Samples. Downloads contains code samples for generating barcode values.
Barcode Verification Tool. Select one of your products on Products page to access the barcode verification tool which enables you to verify your barcode value is correct and expected to work according to your product and ASIN configuration.

1D Barcode requirements

In order to use 1D barcode it is necessary to provide device identification and authentication material by uploading device control logs. Control logs must be uploaded before 1D barcode is scanned in Amazon fulfillment center.

1D barcode encodes a device identification value provided in the control logs.

Learn more about possible device identification values, control logs content, restrictions and the upload process in the control logs specification

If your device packaging already has a printed 1D barcode in Code 39 or Code 128 standards with a supported device identification value like a serial number then it can be reused for pre-registration and a new barcode is not needed.

Otherwise it is recommended to print a new barcode using Code 128 standard.

1D Barcode Sample:

Barcode label can be below or above the barcode and must contain the device identification value in plain text. The label can optionally have additional prefix for the value type e.g. indicating that this is a serial number which should be easy to distinguish from the actual value if it is necessary to enter it manually when the barcode is damaged.

The recommended barcode x-dimension is between 0.01" (0.25 mm) and 0.05" (1.25 mm). The barcode can use a smaller x-dimension if printed with good quality but make sure such a barcode can be scanned by a basic barcode scanner like Honeywell 1900

x-dimension defines the width of the most narrow bar or space within the barcode. The overall barcode width and height is calculated using x-dimension value and the number of encoded symbols according to Code 128 standard using the following formulas:

W = (11 * C + 35) * X
H = max(W * 0.15, 0.25")

Where:
W - Barcode overall width excluding Quiet Space
H - Barcode overall height
C - Number of encoded characters
X - x-dimension

Example:  C = 20, X = 0.01"
      W = (11 * 20 + 35) * 0.01” = 2.55"
      H = max(2.55" * 0.15, 0.25") = 0.3825"

1D barcode overall width should not exceed 8" (200 mm).

FFS icon can be optionally printed on the right side of the barcode after barcode's quiet space to easily identify this barcode as related to FFS. Omit printing this icon if there is not enough space, or the existing barcode is reused for FFS or if there are other reasons to do so.

FFS icon:

Barcode sample with the icon:

2D Barcode requirements

It is also possible to use two-dimensional (2D) barcode for pre-registration, the specification depends on a protocol:

Note: 2D barcode for Wi-Fi protocol can be used only if a corresponding DAK was setup directly on a physical Yubikey device. Refer Wi-Fi provisionee manufacturing for more details.

Version	Date	Author	Description
1.0	Feb 12, 2021.	Amazon.	General Availability