(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.data-privacy-src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-TT9ZP96');

Knowledge Base

Image Templates

Image Templates, or Personalized Images, are image files generated on-the-fly and are typically sent in a message to a particular recipient. Each image can contain rich graphics with personalized text. A unique barcode can also be generated and layered into the image. The resulting personalized image can be delivered, viewed and saved to any phone.

Personalized Image text message

Image Template Builder

An Image Template is created by merging a background image with settings regarding where custom text or a barcode image . Create personalized images in a few steps with the Image Template Builder. You can preview your Image Template on the right side of the page as you work on it.

1. Select the Data Source: Imported Data, API, or People Database. Choosing “Imported Data” will use personalized data that is imported into the template. Choosing “API” will use personalized data supplied in the API to replace the merge tags in the barcode and text areas. Choosing “People Database” will use personal data associated with the phone number from the people database to replace the merge tags in the barcode and text areas.

2. Upload Background Image: First, upload a background image. The max file size of the background image is 200 KB. The file type includes jpg only. The background image will define the exact height and width of your image template. If your background image is too large, the system will resize the image. We recommend the sizes of the background images to be 640px width by 1138px height.

Image template builder - upload background image

3. Add Barcode: Check the “Add Barcode” checkbox to add a dynamic barcode. Add an ID to the barcode. This will generate the barcode image and ID on the preview. You can choose between a number of different types of barcodes. The options currently available are:

  • Aztec Code
  • Code 11
  • Code 128
  • Code 39
  • Data Matrix
  • EAN
  • Interleaved 2of5
  • PDF417
  • QR Code
  • UPC-A

Next, you can choose the font, location, size, and color of the barcode image and ID. Some barcodes change size with more data so be sure to use an appropriate length. You can also add merge tags into the barcode ID by using the {$variable} tags. The tags will be replaced with the data supplied in the API or the People Database if either data source is selected during sending.

Image template builder - add barcode

4. Add Text Area: Check the “Add Text Area/Date Time” checkbox to add personalized text. You can add up to 8 personalized text areas. You can choose the font, location, size, and color of the text. You can also add merge tags into the text areas by using the {$variable} tags. The tags will be replaced with the data supplied in the API or the People Database if either data source is selected during sending. Optionally, you can also add the current date and time in any of the text fields by checking the “Display Current DateTime” box in the text field. The text field will always be replaced with the current date and time during sending.

image template builder - add text areas or the current date and/or time

5: Importing Data via CSV: If the data source for the image template is “Imported Data”, then data imported into the template will be used to replace the barcode ID and text areas (excluding text areas with DateTime) during sending. Select the ‘Import’ link on the Image Template page to import personalized data into a template. Create and upload a CSV file with a row for each image. Data columns can be mapped to correspond with the dynamic fields of the template. Fields include the barcode ID, all 8 text areas, and a phone number. Assigning a phone number will link an image template to a specific recipient. Phone numbers must include the country code.

Image Template FAQs

Is it required to assign a phone number to each personalized image?

No, it is not required to assign a phone number to a personalized image. If you do not assign a phone number then the first phone number that requests this Image Template that is not already assigned code will be assigned this one.

Can I pass the Image Template Data in the API?

Yes, you can simply pass the Image Template Data in the SendSavedMMS API call to replace the merge tags in the barcode ID and text areas and generate the personalized image within that MMS Template. There is currently no API to add data without sending an MMS message or generating the Image Template standalone.

Go to Top