A popup frame is a smaller window that can be opened on top of your flipbook.

In the world of code, this is known as an iframe.

While they can be used to open any kind of web content, the most common way of using it is to enable visitors to shop directly in your webshop or open a store locator.

Benefits of using popup frames

Popup frames can help you retain visitors by allowing them to shop directly in your webshop without leaving the catalog.

Traditional external links, while being easy to implement, move the user into another browser tab. This increases the risk of the visitor not coming back into the catalog after visiting a product page, wasting your effort of retaining the visitor and the resources allocated to creating the flipbook.

Getting started

Now that you know what a popup frame is and what the benefits are, let's focus on getting you started.

Branded domain

We highly recommend setting up a branded domain, to avoid a cross-domain challenges.

CORS is an HTTP-header. Servers use this to recognize the origin of the domain and allow/deny loading resources.

When you try opening a popup which uses a different domain than your flipbooks' domain, your website might not allow it. By using a subdomain that is part of your main domain, you'll get around most of these challenges.

However, it is also possible to open different domains. Find more information on our technical documentation below

If you don’t have a branded domain yet, find how to set it up here:

Enrichment Automation

While popup frames can be created within the Enrichment Editor, you can automate the process by using Enrichment Automation. Only available on select plans.

If you’re not using an Enrichment Automation yet, or want to know more, find all the information here:

Extra navigation options

Here are some suggestions if you want to further improve the experience when using popup frames.

  • Add a direct link to your website, so your customers can access the cart easily.
    You can do this by using our shop configuration, by overriding the default iPaper shop behavior.

    Screen Recording 2021-12-01 at AM

  • Implement a close function in the popup frame. This way, when a user adds a product to your cart, the popup can close by itself.

  • Implement a custom version of your website via query strings. When a customer opens a popup frame, the website is loaded in a simpler and optimized view for better experience.

    For example:


Read more in the technical documentation below.

Limitations and challenges

While the idea of opening your webshop on top of the catalog is great, there are a few things to keep in mind when using popup frames.


Most websites today will block other websites from being iframed to avoid clickjacking. This is a basic security measure to avoid malicious techniques to trick users into revealing confidential information.

Popup frames require a small but technical change on your websites' server, to allow us to iframe your website.

Basket session

In some cases, the basket session will get lost when closing and opening the popup.

There are two main solutions for this:

  • Tweak the session cookie

  • Set up a branded domain to avoid cross-domain challenges.

Technical documentation

The implementation will highly vary depending on your website's current security measures. We recommend involving your IT department to determine what's the best way of achieving this.

Find the technical documentation here:

Alternatives to popup frames

If you're looking for embedding your flipbook in your website and enable shopping functionality, you might want to take a look at our JavaScript integration:

If you want your visitors to shop directly in the catalog with an iPaper basket and then redirect to your webshop, take a look at our Shop Export option:

Did this answer your question?