Skip to main content
Skip table of contents

URL Options

URL options are key=value pairs that customize Katalys Shop's behavior.\ They are appended to the URL after # (anchor), separated by / (forward slash).

https://1o.io/checkouts/:id/:description#/option1=value1/option2=value2

Options

Option

Value

Effects

showClose

showClose=true

Shows "close" button. Emits 1oStorefrontClose message when clicked.

placementId

placementId=:string

Analytics related events will include placementId: ":string".

sendImpression

sendImpression=true (default)

By default when a Katalys shop renders an impression is counted. Customize it, if you thing this should not be the case.

mode

mode=inline (default)

When inserted into content as part of an article or blogpost.

mode=popup

When full screen is available and you want to expand the iframe full screen. It grays out unused space and applies a nice border. On smart phones a dedicated experience is loaded.

mode=fullframe

When appearing inside a nested limited iframe like an ad. Makes full use of space and does not behave like a pop-up window.

startScreen

startScreen=PaymentMethods

Sets a different starting page of the Katalys shop. PaymentMethods value will move user straight into payment method selection. Use this when you gave user enough information for the purchase decision.

selectedVariant

selectedVariant=:ID

Bypasses default variant as the headline of the shop. Communicate with Katalys representative to provide you with desired variant ID.

discountCode

discountCode=shopify-discount

Auto applies a discount code to the checkout. Only supported for shops integrated with Shopify.

Options when 1o.js script is present

Option

Value

Effects

placementId

placementId=:string

Analytics related events will include placementId: ":string".

parentNode

parentNode (dom el.)

Shop is inserted into this Dom element element.

insertBeforeNode

insertBeforeNode (dom el.)

Shop is inserted before this Dom element.

mode

mode=inline (default)

When inserted into content as part of an article or blogpost.

mode=popup

When full screen is available and you want to expand the iframe full screen. It grays out unused space and applies a nice border. On smart phones a dedicated experience is loaded.

mode=fullframe

When appearing inside a limited iframe like an ad or layout designed by you. Makes full use of space and does not look like a pop-up (modal) window.

startScreen

startScreen=PaymentMethods

Sets a different starting page of the Katalys shop. PaymentMethods value will move user straight into payment method selection. Use this when you gave user enough information for the purchase decision.

selectedVariant

selectedVariant=:ID

Bypasses default variant as the headline of the shop. Communicate with Katalys representative to provide you with desired variant ID.

width

width=:int (px)

Set width in pixels. Applicable only when mode=inline.

height

width=:int (px)

Set height in pixels. Applicable only when mode=inline.

preload

preload=true

Preload the shop before the link is clicked. This loads the shop in the background to make instantly appear when link is clicked.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.