# Placeholder Examples ## 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.
PlaceholderDescriptionExample
{{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. | Placeholder | Description | Example | | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------- | | {{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 | | {{email/non-clickable}} | Email address of the recipient | | ### Carrier Information Example placeholders related to carriers are described in the following table. | Placeholder | Description | Example | | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | {{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 | | {{plMessage/locale}} | Message in the scan of the carrier as matched with our status model. | Scheduled | | {{courierDeepLinkURL/locale}} | Link to the carrier’s tracking page. Can also be used to change delivery options when reroute is not available. | | | {{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. | Rearrange delivery btton | | {{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. | Placeholder | Description | Example | | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | {{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. | Track your delivery button | | {{trackingUrl}} | URL of the Order Status page for usage with own HTML (that is: buttons, links or similar events). | | | {{articlesTableWithImages}} | Article list of items with images. | Article list table with items and 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. | Map integration of pickup point location | | {{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](/docs/engage/messages-and-journeys/overview/visual-enhancements.md#carrier-gifs). | Dispatched carrier GIF | | {{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](/docs/engage/messages-and-journeys/overview/visual-enhancements.md#carrier-gifs). | Delayed carrier GIF | | {{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](/docs/engage/messages-and-journeys/overview/visual-enhancements.md#carrier-gifs). | Delivered carrier GIF | ## 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 `IF` and `ENDIF` conditional elements display as {{#placeholder}}content{{/placeholder}} in the HTML editor. * The “if is not” condition using the `UNLESS` and `ENDUNLESS` conditional 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. | Placeholder | Description | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

{{#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. | Placeholder | Description | Example | | ------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | {{showArticlesTableWithImages}} | Article list of items with images. | Article list table with items and images | | {{showUpdateRearrange2col}} | Content block to allow customers to rearrange their delivery. | Options to rearrange the delivery | | {{showOrderInfo2col}} | Display the order information in a two-column layout. | Two-column layout of order information | | {{showOrderInfo3col}} | Display the order information in a three-column layout. | Three-column layout of order information | | {{showRatingWidget}} | Display a rating widget in the email content to gather feedback. | Rating widget | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.parcellab.com/docs/engage/messages-and-journeys/configuration/conditional-placeholders/placeholder-examples.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.