Customize Pay Later messages

Change the style and layout of your Pay Later messaging

DocsCurrentLast updated: October 1st 2021, @ 12:44:48 pm


Learn about the customization options you can use to modify the style and layout for your Pay Later messaging.

On this page

Product or cart amount

You can display a shorter message to your customers by passing in a qualifying amount to the message. Additionally, your customers can see their payment amount and associated fee when they click on the message.

For your product detail and product list pages, include the product's price in the amount parameter. For your cart or checkout pages, include the total cart value in the amount parameter.

Note: Including data-pp-amount only displays a shorter message if the amount that’s passed in is between the minimum and maximum purchase amount.

Example

<div
  data-pp-message
  data-pp-placement="product"
  data-pp-amount="120.00"
>< /div>

Page type

Use the data-pp-placement attribute to identify the type of page a message appears and if the customer interacted with the message. This attribute accepts home, category, product, cart, and payment as values.

Example

<div
  data-pp-message
  data-pp-placement="product"
>< /div>

Layout and style

You can configure messages for different layouts and styles using optional HTML attributes.

The message layout determines the available style options. The two layout options are:

  1. Lightweight Text-Based Messages
  2. Flexible Display Banners

The HTML attribute data-pp-style-layout determines the message layout. If you omit this attribute, then the layout uses the default value text. Setting this value to flex renders your message as a flexible display banner.

1. Lightweight text-based messages

This message layout is ideal for placement underneath product and cart prices throughout your site.

  • Inline HTML attribute: data-pp-style-layout, value: text

Example

<div
    data-pp-message
    data-pp-placement="product"
    data-pp-amount="120.00"
    data-pp-style-layout="text"
></div>

Renders

Pay later messaging text primary left black

For lightweight text-based messages, you can configure the following attributes:

  • Logo type
  • Logo position
  • Text color
  • Text size
  • Text align

Logo Type

  • Inline HTML attribute: data-pp-style-logo-type

Sets the PayPal logo used in the message.

Set this attribute's value to one of the following:

Value Description Preview
primary Default. Full PayPal Logo. Pay later messaging text primary left black
alternative PayPal monogram Logo. Pay later messaging text alternative left black
inline Single line PayPal Logo without monogram. Pay later messaging text inline black
none No logo. Text only. Pay later messaging text inline black
Example
<div
    data-pp-message
    data-pp-placement="product"
    data-pp-amount="120.00"
    data-pp-style-layout="text"
    data-pp-style-logo-type="alternative"
></div>
Renders

Pay later messaging text alternative left black

Logo Position

  • Inline HTML attribute: data-pp-style-logo-position

Sets the position of the PayPal logo in the message.

Note: This option is only available with logo.type values: primary

Set this attribute's value to one of the following:

Value Description Preview
left Default. Logo left of the text. Pay later messaging text primary left black
right Logo right of the text. Pay later messaging text primary right black
top Logo above the text. Pay later messaging text primary top black
Example
<div
    data-pp-message
    data-pp-placement="product"
    data-pp-amount="120.00"
    data-pp-style-layout="text"
    data-pp-style-logo-position="top"
></div>
Renders

Pay later messaging text primary top black

Text Color

  • Inline HTML attribute: data-pp-style-text-color

Sets the text and logo color of the message.

Set this attribute's value to one of the following:

Value Description Preview
black Default. Black text with a colored logo. Pay later messaging text primary left black
white White text with a white logo. Pay later messaging text primary left white
monochrome Black text with a black logo. Pay later messaging text primary left black
grayscale Black text with a grayscale logo. Pay later messaging text primary left white
Example
<div
    data-pp-message
    data-pp-placement="product"
    data-pp-amount="120.00"
    data-pp-style-layout="text"
    data-pp-style-text-color="white"
></div>
Renders

Pay later messaging text primary left white

Text size

Sets the size of the message text.

Object property (path) Inline HTML attribute Possible values
style.text.size data-pp-style-text-size 10, 11, 12, 13, 14, 15, 16

Set this option to one of these values:

Value Description Preview
10, 11 Smaller text sizes. Two Australian text message for a Pay Later offer with 10 and 11 pixel font, left-aligned, black text on a white background, with a PayPal logo displaying only the PayPal icon on the left side of the text
12 Default. Standard text size. Australian text message for a Pay Later offer with 12 pixel font, left-aligned, black text on a white background, with a PayPal logo displaying only the PayPal icon on the left side of the text
13, 14, 15, 16 Larger text sizes. Four Australian text message for a Pay Later offer with 13, 14, 15, and 16 pixel font, left-aligned, black text on a white background, with a PayPal logo displaying only the PayPal icon on the left side of the text

Text align

Sets the direction the text aligns for text layout messages.

Object property (path) Inline HTML attribute Possible values
style.text.align data-pp-style-text-align left, center, right

Set this option to one of these values:

Value Description Preview
left Default. Text is left aligned Australian text message for a Pay Later offer with 12 pixel font, left-aligned, black text on a white background, with a PayPal logo displaying the PayPal icon and name on the left side of the text left
center Text is center aligned Australian text message for a Pay Later offer with 12 pixel font, left-aligned, black text on a white background, with a PayPal logo displaying the PayPal icon and name on the left side of the text center
right Text is right aligned Australian text message for a Pay Later offer with 12 pixel font, left-aligned, black text on a white background, with a PayPal logo displaying the PayPal icon and name on the left side of the text right
Example
<div
  data-pp-message
  data-pp-placement="home"
  data-pp-amount="120.00"
  data-pp-style-layout="text"
  data-pp-style-align="center"
></div>
Renders

Australian text message for a Pay Later offer with 12 pixel font, left-aligned, black text on a white background, with a PayPal logo displaying the PayPal icon and name on the left side of the text center

2. Flexible display banners

This message layout is ideal for placement above the fold on your home and product category pages. Designed to be eye-catching, they inform your customers of pay later offers.

  • Inline HTML attribute: data-pp-style-layout, value: flex

Example

<div
    data-pp-message
    data-pp-placement="home"
    data-pp-amount="120.00"
    data-pp-style-layout="flex"
></div>

Renders

Pay later messaging flex 1x1 blue

You may set color and ratio attributes as described below.

Color

  • Inline HTML attribute: data-pp-style-color

Sets the color of the message.

Set this attribute's value to one of the following:

Value Description Preview
blue Default. Blue background with white text and white logo. Pay later messaging flex 1x1 blue
black Black background with white text and white logo. Pay later messaging flex 1x1 black
white White background with blue text, colored logo, and blue border. Pay later messaging flex 1x1 white
gray Light gray background with blue text and colored logo. Pay later messaging flex 1x1 gray
monochrome White background with black text and black logo. Pay later messaging flex 1x1 gray
grayscale White background with black text and grayscale logo. Pay later messaging flex 1x1 gray
Example
<div
    data-pp-message
    data-pp-placement="home"
    data-pp-amount="120.00"
    data-pp-style-layout="flex"
    data-pp-style-color="black"
></div>
Renders

Pay later messaging flex 1x1 black

Ratio

  • Inline HTML attribute: data-pp-style-ratio

Sets the shape and size of the message.

Set this attribute's value to one of the following:

Value Description Preview
1x1 Default. Ratio of 1x1 that flexes between 120px and 300px wide. Pay later messaging flex 1x1 blue
1x4 Ratio of 1x4 that is 160px wide. Pay later messaging flex 1x4 blue
8x1 Ratio of 8x1 that flexes between 250px and 768px wide. Pay later messaging flex 8x1 blue
20x1 Ratio of 20x1 that flexes between 250px and 1169px wide. Pay later messaging flex 20x1 blue
Example
<div
    data-pp-message
    data-pp-placement="home"
    data-pp-amount="120.00"
    data-pp-style-layout="flex"
    data-pp-style-ratio="8x1"
></div>
Renders

Pay later messaging flex 8x1 blue