Placeholder Examples
Use placeholders in your emails to personalize your customer communication and provide relevant information to your customers at each stage of the post-purchase journey.
Overview
You can use placeholders in email messages to populate variable content elements by referencing data in the parcelLab system that enables you to design communication tailored for your customers.
Placeholders List
parcelLab has a set of defined placeholders to use in the setup of your email communication. Some examples of the available placeholders are described in the following sections.
Shop Information
Example placeholders related to your shop are described in the following table.
{{shopName}}
Name of the shop.
Parker's
{{shopUrl}}
The URL of your shop.
https://weareparkers.com
{{highlightColor/client}}
Main color used by the shop in the branding of messages.
#3B1932
{{generated/voucher}}
Voucher code for the shop (for example: used in the case of delays). You can upload a voucher code in a file in the Admin module in the App.
PARKERS20%OFF
Recipient Information
Example placeholders related to recipients are described in the following table.
{{recipient_notification}}
Name of the recipient used in notifications. Usually recipient first and last name.
Julian Krenge
{{street}}
Street of the delivery address.
75 State Street
{{zip_code}}
Zip code of the delivery address.
02109
{{city}}
City of the delivery address. It also returns the state abbreviation if applicable (that is: for US addresses).
Boston, MA
{{city/no-state}}
City of the delivery address only.
Boston
{{country}}
Country of the delivery address.
USA
{{destination_country_iso3}}
ISO 3166-1 alpha 3 destination country of delivery.
USA
{{destination_country_iso3/billing_info}}
ISO 3166-1 destination country of the billing address.
CAN
Carrier Information
Example placeholders related to carriers are described in the following table.
{{courier}}
parcelLab carrier code.
dhl-germany
{{courier/pretty}}
Name of the carrier
DHL
{{destinationCourier/pretty}}
Name of the last mile carrier in case of a carrier change during shipping.
UPS
{{courierDeepLinkURL/locale}}
Link to the carrier’s tracking page. Can also be used to change delivery options when reroute is not available.
https://www.dhl.com/gb-en/home/tracking.html
{{courierRerouteButton/locale}}
"Rearrange delivery" button in the highlight color of the shop with rounded corners that navigates to the carrier page allowing the shopper to modify delivery options.
{{date/next-courier-work-day}}
Next working date of the carrier.
02/07/2024
Parcel/Shipment Information
Example placeholders related to parcel and shipments are described in the following table.
{{orderNo}}
Order number.
PK1004
{{orderNo/non-clickable}}
Order number displayed in plain text (that is: to avoid being interpreted as a phone number and turned clickable).
PK1004
{{tracking_number}}
Tracking number.
PK1234567890
{{warehouse}}
Warehouse from where the delivery was shipped.
Parker's Fulfilment Center
{{plNextAction/locale}}
Next action status that is required for the delivery.
Scheduled
{{date/full}}
Current date.
01/07/2024
{{date/short}}
Current day and month.
01/07
{{date/year}}
Current year.
2024
{{date/day}}
Current day.
01
{{announced_delivery_date}}
Announced delivery date.
Monday 1 July 2024
{{plSpecifics/locale}}
Date and delivery time window of scheduled window with delivery instructions, such as neighbor name, if provided.
On Monday 01/07/2024, between 12:00 and 18:00
{{trackingButton}}
"Track your delivery" button in the highlight color of the shop with rounded corners that navigates to parcelLab’s Order Status page.
{{trackingUrl}}
URL of the Order Status page for usage with own HTML (that is: buttons, links or similar events).
https://www.delivery-status.com/?courier=ups&trackingNo=PK1004&lang=en
{{articlesTableWithImages}}
Article list of items with images.
{{tinyArticlesList}}
Article list of items only.
1x AP-OU-BOD-2312: Olive Denim Jacket
1x AP-SH-BRL-2313: Red Leather Boots
{{plMap/locale}}
Maps integration with the address of the pickup point and opening hours.
{{generated/opening-hours}}
Opening hours of the pickup point.
Opening hours Monday-Saturday: 08:00-22:00 Sunday: 09:00-20:00
{{storageTime/courier}}
Total storage time at the pickup point.
7 working days.
{{maxStorageTime/courier}}
Maximum time a shipment will be stored at the pickup point.
7 workings days.
{{lastStorageDate/courier}}
Latest storage date before a shipment will be returned to the warehouse.
Wednesday 24 July
{{preview}}
The preview text displayed by all established email programs before the user has opened the email. Smartphones often display this preview in the notification.
Parker’s Order PK1004.
Your order has been collected by UPS and you can now track it.
{{Dispatched/gif}}
Carrier GIF for a package that’s been dispatched. The carrier is automatically used based on the current shipment. For further information, see the current list of supported carriers.
{{Delayed/gif}}
Carrier GIF for a package that’s been delayed. The carrier is automatically used based on the current shipment. For further information, see the current list of supported carriers.
{{Delivered/gif}}
Carrier GIF for a package that’s been delivered. The carrier is automatically used based on the current shipment. For further information, see the current list of supported carriers.
Conditional Placeholders
You can use conditional placeholders to display specific content based on relevant values. The following types of conditional placeholders can be used:
The “if is” condition using the
IFandENDIFconditional elements display as {{#placeholder}}content{{/placeholder}} in the HTML editor.The “if is not” condition using the
UNLESSandENDUNLESSconditional elements display as {{!placeholder}}content{{|placeholder}} in the HTML editor.
Examples of conditional placeholders that can be used in emails are described in the following table.
{{#isESP/boolean}content{{/isESP/boolean}} {{!isESP/boolean}content{{/isESP/boolean}}
To display specific content for a country with the country ISO Alpha 3 code (for example: ESP for Spain).
{{#courier=dhl-germany}}content{{/courier=dhl-germany}} {{!courier=dhl-germany}}content{{/courier=dhl-germany}}
To display specific content for a carrier with the carrier code (for example: dhl-germany for DHL Germany).
{{#articles}}content{{/articles}} {{!articles}}content{{/articles}}
To display specific content if articles are present in the tracking.
{{#expected}}content{{/expected}} {{!expected}}content{{/expected}}
To display specific content if the shipment is expected by the carrier.
{{#incomplete}}content{{/incomplete}} {{!incomplete}}content{{/incomplete}}
To display specific content if the shipment is a partial delivery.
{{#complete}}content{{/complete}} {{!complete}}content{{/complete}}
To display specific content if the shipment is complete.
{{#hasMultipleDeliveriesInOrder/system}}content{{/hasMultipleDeliveriesInOrder/system}} {{!hasMultipleDeliveriesInOrder/system}}content{{/hasMultipleDeliveriesInOrder/system}}
To display specific content if there is more than one delivery for an order (that is: for split shipments).
{{#areAllTrackingsDispatched/system}}content{{/areAllTrackingsDispatched/system}}content {{!areAllTrackingsDispatched/system}}content{{/areAllTrackingsDispatched/system}}content
To display specific content if all trackings in an order are dispatched.
{{#areAllTrackingsDelivered/system}}content{{/areAllTrackingsDelivered/system}}content {{!areAllTrackingsDelivered/system}}content{{/areAllTrackingsDelivered/system}}content
To display specific content if all trackings in an order are delivered.
{{#plNextAction/system=NewAttemptNextDay}}content{{/plNextAction/system=NewAttemptNextDay}} {{!plNextAction/system=NewAttemptNextDay}}content{{/plNextAction/system=NewAttemptNextDay}}
To display specific content if the next action is transmitted by the carrier. Instead of our standard which is displayed through {{plNextAction/locale}}. Can also be used for: NewAttemptToday, PickUpReady, and Scheduled.
{{#plException=AddressIssue/system}}content{{/plException=AddressIssue/system}} {{!plException=AddressIssue/system}}content{{/plException=AddressIssue/system}}
To display specific content if a delay reason is provided by the carrier. Works with any delay reason defined in the system (for example: TimeIssue, Misrouted, and LackSpace).
{{#returnReason=AddressIssue/reporting}}content{{/returnReason=AddressIssue/reporting}} {{!returnReason=AddressIssue/reporting}}content{{/returnReason=AddressIssue/reporting}}
To display specific content if a return reason is provided by the carrier. Works with any return reason defined by the function guessReturnReason (for example: CustomerRefusal, NotCollected, Damaged, and Recall)
Message-Specific Placeholders
You can include message-specific placeholders from the message settings and the list of placeholders in the HTML editor for a message.
Examples of message-specific placeholders that can be used in emails are described in the following table.
{{showArticlesTableWithImages}}
Article list of items with images.
{{showUpdateRearrange2col}}
Content block to allow customers to rearrange their delivery.
{{showOrderInfo2col}}
Display the order information in a two-column layout.
{{showOrderInfo3col}}
Display the order information in a three-column layout.
{{showRatingWidget}}
Display a rating widget in the email content to gather feedback.
Last updated
Was this helpful?