Display Klarna On-Site Messaging on your Shopify store by installing the app and customizing dynamic or static placements across key pages for a tailored shopping experience.
To add app block placements you need to first have installed the Klarna On-Site Messaging app correctly.
You also need to have a theme that supports Online Store 2.0 app blocks. For vintage themes please see Vintage Ad Placements.
Placements are containers for the different messaging assets we offer. Placements are either dynamic, that is, the messaging is updated based on the purchase amount, or static, meaning that the messaging isn’t linked to the amount and isn’t updated dynamically.
You can add placements to the following types of pages in your Shopify store:
- Product Page supports amount-based (dynamic) and non-amount based (static) placements.
- Cart Page supports amount-based (dynamic) and non-amount based (static) placements.
- Home Page supports non-amount based (static) placements.
- Collections Page supports non-amount based (static) placements.
- Static Page supports non-amount based (static) placements.
If you’re not sure which placements to pick, see the answer in our Frequently asked questions.
You can navigate to App Blocks through the On-Site Messaging home page by clicking Go to App Block Instructions and then proceeding to click Open customizer.
- In your Store admin > Sales channels > Online store, click the Customize button to add a Klarna Placement app block to your desired theme templates. You can also navigate from the app's main page by clicking Go to App Block Instructions and then clicking Open customizer.
- From the select box in the top center of the theme editor, select the desired theme, for example, Products > Default product. Then, in the left-side menu, use the Add block option to add a Klarna Placement, available under APPS, as shown in the screenshot below. ''If you are not able to find Klarna On-Site Messaging under APPS, you may need to instead use the CSS method in the vintage ad placement installation method.
After inserting the block, drag the Klarna Placement App Block to the desired location in the template.
3. After inserting the block, use the 6 dots to the far right to drag the Klarna Placement App Block to the desired location in the template, for example, below Price.
4. You can edit the configuration options within the Klarna Placement app block by selecting between options in the dropdown menu and choosing between default, dark and custom theme (read more below on customizing placements with custom theme).
The configuration options available within the Klarna Placement app block.
If you want to customize the the placements in your Shopify store, you can do it in one of the following ways:
- Edit the underlying CSS styling in your store’s source code, as described in the Customize placements with CSS article on Klarna.Docs.
- Edit the placements in the Klarna Merchant portal, as described in the Customize placements through Merchant portal article on Klarna.Docs.
Note that only the Custom theme is customizable. If you use the default or dark theme, you won’t be able to see any customizations in the storefront.
Some customization options, that is, changes in padding and alignment, affect the placement itself and not the contents of the placement. These options are available in the Klarna On-site messaging Shopify app in Shopify admin.
Customizations in the app and the Merchant portal impact the placement differently and you may need to apply the custom styling in both to see the desired result. Examples of such customization are the Merchant portal placement text alignment within the placement and the Ad Position alignment in the Klarna OSM Shopify app that affects the position of a placement on the page. Additionally, only selected Klarna placements support text alignment within the placement, and some themes may not honor the styling for placement alignment on the page.
Klarna’s On-site Messaging app ensures the currency your customers see in the placement matches the currency displayed on your storefront. Learn more here.
Checkout On-site Messaging is only available for Shopify plus merchants. Ensure you have completed the steps outlined in the article Install the On-site messaging app before proceeding with adding checkout messaging. You will also need to ensure you have upgraded to the Shopify Checkout Extensibility.
How to add Checkout On-site Messaging:
- Navigate to Sales channels > Online Store > Themes > Customize or Apps > Klarna On-Site Messaging > Go to App Block Instructions > Open customizer.
- Add a product to your cart.
- Proceed to the checkout page.
- Click on Customize checkout.
- Click on Add app block (bottom of the page).
- Select Klarna On-Site Messaging and proceed to select customization options. Note: These are currently limited as we work to enable more features.
An example of Klarna On-Site Messaging in a Shopify store's checkout.
There are a few customization options available for the checkout placement. It can be enabled or disabled within the ShopPay checkout. We recommend this to be enabled as customers may struggle to navigate to Klarna from the ShopPay checkout without guidance. You can add this by clicking Checkout behavior in the app settings and checking the box Include app block in Shop Pay.
We offer customized messaging for this purpose that can be enabled by reaching out to your partner success team or merchant@klarna.com.
An example of customized messaging in the ShopPay checkout.
Error messaging in the settings are descriptive and will explain in what cases (and with which settings) the messaging will not show to your customers. An example of this is if a customer country is not enabled on your Klarna merchant ID. In such a case the messaging would not be displayed to customers in that country as they would not be able to proceed with Klarna as a payment method.