BarCodeUrl()

Generates a barcode based on an input string. Most of the barcode types that the function can generate are linear (one-dimensional), although it can generate two-dimensional Data Matrix and PDF417 codes. The function can’t be used to create QR codes.

You can call this function up to two times per message or landing page.

Availability

Syntax

BarCodeURL(valueToConvert, barcodeType,
           width, height, checksumValue,
           boolShowText, altText,
           rotation, boolTransparentBG)

The BarCodeURL() function has nine parameters:

• valueToConvert (string): Required. The value that you want to convert into a barcode.
• barcodeType (string): Required. The type of barcode to create. See Supported Barcode Types for a list of possible values.
• width (number): Required. The width of the barcode in pixels.
• height (number): Required. The height of the barcode in pixels.
• checksumValue (string): A checksum value for the barcode.
• boolShowText (boolean): If true or 1, the function includes the text of valueToConvert under the barcode.
• altText (string): Alternate text to display under the barcode. The function only adds the specified text to the barcode when the value of boolShowText is false.
• rotation (number): Orientation of the barcode in degrees. Accepted values: 0, 90, 180, 270.
• boolTransparentBG (boolean): If true or 1, the barcode includes a transparent background. Otherwise, the background is white.

Supported Barcode Types

The BarCodeUrl() function supports a variety barcode encoding standards. This table describes the features and limitations of each supported barcode type.

note: The function lets you specify some barcode types that aren’t supported. If you specify any of the values in this list, the function doesn’t produce an exception, but it also doesn’t output a barcode.

• mat25
• onecode
• plaintext
• planet
• postnet
• telepen

Usage

To call the function, pass the string that you want to encode, the barcode type to use, and the width and height of the barcode, along with any optional arguments. Some barcode types, such as EAN 8 or UPC A, only accept a certain number of characters. When you use a non-variable-length barcode type, and you include an incorrect number of characters, the function doesn’t render the barcode.

If you call the function using optional parameters, you must include all of the parameters that precede it. For example, if you want to include the altText parameter, you must also include the checksumValue and boolShowText parameters. In this situation, you can pass empty strings if it's unnecessary to provide a string value. Continuing the example, if it's unnecessary to provide a value for the checksumValue parameter because the barcode type you selected includes a checksum by default, you can pass an empty string.

Basic Usage

To render the barcode, enclose the function code in an HTML <img> tag. This example creates a Code 128 Auto barcode that includes the URL of the Salesforce website.

<img src="%%=BarcodeURL("https://www.salesforce.com", "code128auto", 150, 50)=%%">

The rendered HTML email or landing page includes this barcode.

Alternative Text

This example creates a Code 128 Auto barcode in which the encoded data is the URL of the Salesforce website. Rather than print the same text below the barcode, this example uses the altText parameter to specify a different printed string.

<img src="%%=BarcodeURL("https://www.salesforce.com", "code128auto", 150, 50, "", 0, "Salesforce Website")=%%">

note: Code 128 Auto barcodes include an internal check digit by default, so you can pass an empty string for the checksumValue parameter.

The rendered HTML email or landing page includes this barcode.

Rotation

This example creates a Code 128 Auto barcode that is rotated 90° clockwise.

<img src="%%=BarcodeURL("https://www.salesforce.com", "code128auto", 150, 50, "", 0, "Salesforce Website", 90)=%%">

The rendered HTML email or landing page includes this barcode.