How to open lightbox flipbook from a button or image?

1. Assign a custom CSS class and remove default thumbnail via shortcode parameters

[real3dflipbook id="1" thumb="" class="book1"]

or with

Edit Flipbook > Lightbox > CSS class


Edit Flipbook > Lightbox > Hide thumbnail > Enabled

2. Add the flipbook shortcode to the page

3 . Add the same CSS class to your button or image that should open the lightbox

1. Add shortcode to page, set unique deep linking prefix for the book via shortcode

[real3dflipbook id="1" thumb="" deeplinkingprefix="book1_"]

2. Add a link to page, set href attribute to the same deep linking prefix and add a page number at the end

<a href="#book1_1">Open book></a>

How to move flipbooks to another server?

You can easily move your flipbooks to another server. You need to

1. move all assets (images, pdf-s) to new server

2. export flipbooks to JSON

3. edit JSON- replace all paths to pages and pdf-s in json with new paths

4. on new server import from the edited JSON

Unable to save flipbook settings / unable to add new flipbook

Increase max_input_vars in your php.ini from default 1000 to higher value, for example 3000 and restart server. If you don’t find max_input_vars in your php.ini file then add it like this


save and restart server. Make sure that max_input_vars in not commented out with semicolon at the beginning of the line like this


Plugin installation failed

You uploaded the zip that is not valid WordPress plugin (wrong zip file).

Installable plugin file real3d-flipbook.zip is inside the main zip that you downloaded from Codecanyon.

You can also download only installable WordPress plugin from Codecanyon.

PDF Flipbook loading slow

Make sure your server supports range requests. That is required so PDF pages can be rendered before entire PDF is downloaded.

JPG Flipbook loading slow

Optimize JPG-s for web use. Images should be 200-300kb in size and maximum 2000 - 3000 px in height.

Can I load a PDF/images from another server (cross domain request)?

By default PDF and images needs to be on the same server. To use resources from another domain you need to add Access-Control-Allow-Origin header to server response, for example to allow http://foo.example to load the resources you need to add header

Access-Control-Allow-Origin: http://foo.example

Flipbook is not working

Please check your browser console for errors. In most cases the problem is that flipbook has no PDF/images specified, or is trying to load PDF/images from another domain. If you see CORS error, please see how to enable CORS for PDF https://real3dflipbook.gitbook.io/wp/pdf-flipbook#pdf-from-another-domain

There might also be other javascript errors on the page, coming from another plugin. Try to disable other plugins to see if another plugin is causing the problem.

How to update the plugin to latest version

When updating to new version, your current flipbooks will remain saved.

Step 1. Re-download the plugin zip file from your Codecanyon downloads page

Step 2. Deactivate and delete the current version

Step 3. Install and activate the new version

How to optimize flipbook for mobile

There are couple of ways to increase performance and stability on mobile devices.

Reduce page resolution

If you have PDF flipbook, you can reduce page resolution for mobile with

Mobile > PDF page size (full) > 1500

Change view mode

Use different flipbook view mode for mobile (3d or swipe) instead of default webgl

Mobile > View Mode > 3d

Use PDF Tools Addon

With this addon you can optimize flipbook by converting it to images and JSON that will be saved on the server, which will increase flipbook performance and stability

Last updated