Message placement and amount
Render effective messaging with message placement and product amount
DocsCurrentLast updated: September 27th 2022, @ 2:18:58 pm
On this page
data-pp-layout="text"), placed near your product's price, and configured with the product's price using
To maximize sales, place messages throughout your site, including the home, category, product, and cart pages. More specifically:
When customers arrive at your site: Use prominent (
data-pp-layout="flex") messaging above the fold on your home page and category pages to show customers that financing options are available. This makes it more likely for them to consider larger purchases.
When customers are shopping on your site: Reinforce financing options with more subtle messages (
data-pp-layout="text") on product pages to remind customers of PayPal's buy now, pay later options. These contextual messages provide specific and strong value propositions to your customers. Remember to pass the amount of the product to the SDK so you render the best message possible.
When customers are checking out: Both large (
data-pp-layout="flex") and contextual (
data-pp-layout="text") messages work well on cart and payment pages. Placing the contextual messages near the PayPal checkout button reinforces to shoppers that they can use Pay Later offers.
Tag your messages with the page type
You can include the
data-pp-placement attribute to your messaging integrations. This parameter lets the SDK understand the page type on which the message is being rendered. This data is useful for you to view analytics about the performance of the messages in your Insights dashboard. See the Reference table for allowed values for
Product or cart amount
Adding the product price or total cart amount can render the most effective message to your customers. For example, if you pass in an amount that qualifies for Pay in 3, the rendered message likely includes specific payment information. These detailed, specific messages perform better and provide more value to you and your customers. If you do not provide an amount, PayPal falls back to a more general message that, though still effective, has a weaker value proposition to your customers.
Updating the amount dynamically
If your website updates the price of a product or cart's total amount on the client-side, update the amount that is passed to the SDK so that PayPal can update the message accordingly. If you're using the
data-pp-amount attribute to pass the amount (which is the recommended integration), you can update the value of this attribute; the SDK continuously monitors for any changes to the value of
data-pp-amount and re-renders the message if necessary.