Klarna Docs - Known Constraints

Known Constraints

The following incompatibilities have been debugged and have been determined to not be compatible with the app:

These either block the preview of the storefront page within the app or block the storefront functionality of the app.

The Discount on Cart Pro Shopify app updates klarna-placement data-purchase-amount based on items in the cart. When the items in the cart do not match the product page, the data-purchase-amount does not match the product price, causing On-site messaging price to be inaccurate. For additional debugging, you can get logging by adding the URL param "?docp-test-log".

This app relies on Shopify standard use of certain theme variables, such as the product and template variables.  If theme code overwrites these variables in a non-standard manner, the theme will not be compatible.

e.g. if a liquid file contains:

JAVASCRIPT
{%- assign product = null -%}
or
{%- assign template = template.name | handle -%}

As Klarna Payments can only accept orders in the store’s base currency (which is a Shopify restriction for alternative payment methods per Known Issues), the on-site messaging is hidden when the selected currency does not match the store’s base currency when using standard currency switcher functionality.

Currently, for active Ad Positions, the app displays on-site messaging for all in-stock products.  

Currently merchants integrated with Klarna as a local payment method within Shopify Payments do not have access to the Klarna Merchant Portal and access to their Klarna API credentials, which are currently required for Klarna On-site messaging, but this is on our roadmap to support in the future hopefully.   This app supports stores with Klarna Payments integrated as an Alternative Payment Provider (under Shopify admin -> Settings -> Payment providers -> Alternative payments).

Any Klarna merchant can use static Klarna marketing images are available at "Marketing Assets" at docs.klarna.com

If your store's theme supports mini-cart as HTML, On-site messaging can work for mini-carts. To check if your theme supports this:

  1. Navigate to the page where you want to add the placement
  2. Use the browser's Developer Tools to inspect the mini-cart HTML
  3. Right click the page, select 'View Page Source'
  4. Attempt to find the mini-cart HTML in the page source. If the mini-cart HTML is present in the page source, it is supported for on-site messaging placements.

For the On-site messaging app's Ad Position for mini-cart, select the 'Product' page type and use the CSS install method (Vintage option, not App Blocks) is required (unless your theme supports a mini-cart theme template for App Blocks); Drag and drop or Auto Picker install methods do not work as mini-cart pages can't be previewed. In order to use the CSS install method, you need to determine an appropriate CSS selector, which can be found using the browser Dev Tools. A unique selector on the page that is consistent for any variation of the page works best. Alternatively, you can add a custom CSS selector to the page.

The on-site messaging app admin does now work on the Safari browser within the Shopify store admin.

Device manufacturers do not provide infinite support and operating system upgrades. After manufacturers stop providing operating system upgrades, it is not supported to keep the web browsers on that device up to date, thus the web browser stays on an old version.

While we make every effort to support as many browsers and platforms as possible, these outdated browsers are not possible to support without providing a worse experience for recent browsers and other users.

If the On-Site Messaging app does not work on your device, ensure you have upgraded the operating system to the latest version. If the On-Site Messaging app still does not work, then your device may not be supported for modern web browser features.

App block support is available now within the app, but Vintage option is still available for any theme. More info about Shopify's Online Store 2.0 at https://help.shopify.com/en/manual/online-store/themes/managing-themes/versions