Help centre

How to turn a PDF into a flipbook your customers can buy from, put it anywhere on your store, and fix the handful of things that usually go wrong.

Getting started

How to create a flipbook from a PDF

Upload a PDF on the Catalogs page, place your buttons in the editor, then share or embed the link.

CatalogZine turns a PDF into a page-flip book at a public link. Everything starts on the Catalogs page in your Shopify admin.

  1. Name the PDF file before you upload it. The catalog takes its name from the filename, and that same name is used for the storefront page if you press Embed later. A catalog cannot be renamed in the app, so changing it means uploading the file again under a better name.
  2. Open CatalogZine and go to Catalogs.
  3. Press Upload PDF at the top of the page, or drag the file onto the drop zone under Add a catalog.
  4. Wait for the upload progress to finish. The hotspot editor opens fullscreen on its own.
  5. Pick what you want to place in the toolbar palette: Add to cart, Product hotspot, YouTube video, Image or Link. The palette is icons only — hover one to read its name. Then click the page to drop one, or drag to draw it at the size you want.
  6. Press Save. Preview saves first, then opens the real flipbook in a new tab.

Close the editor and you are back on the catalog list. Copy link gives you the share URL, which looks like https://catalogzine.com/book/cat_6l1b1vwawte27zeaiykvdcom. Embed puts the book on your online store — see How to add a flipbook to a store page.

PDF only. Up to 150 MB per file, 2000 pages, and 5000 elements per catalog. The upload is rejected unless the file really is a PDF and the filename ends in .pdf, so renaming another file type will not get it through.
The Pages column shows a dash until you have opened the catalog in the editor and saved it once. That first save is when the page count is recorded, and opening the editor is what captures the cover image from page 1.

An element's type is fixed once it is placed. To change a button into a video, remove it and draw a new one.

How to create a flipbook from images

The app reads PDFs only. Combine your images into one PDF on macOS or Windows, then upload that.

CatalogZine reads PDFs. There is no image upload. Combine your JPEGs or PNGs into a single PDF first, then upload that file — macOS and Windows both do this without extra software.

If the catalog is really a list of products you sell, having it generated from your Shopify products is less work than assembling images by hand.

Whichever route you take, rename the files so they sort in reading order first: 01.jpg, 02.jpg, 03.jpg and so on. The order they are sorted in is the order they are combined in.

macOS

  1. Select all the images in Finder.
  2. Right-click, then choose Quick ActionsCreate PDF.
  3. Rename the PDF that appears next to them — that name becomes the catalog name.

Preview works too: open the images, select every thumbnail in the sidebar, then FilePrint and choose Save as PDF from the PDF menu at the bottom left.

Windows

  1. Select the images in File Explorer, right-click, then choose Print.
  2. Set Printer to Microsoft Print to PDF.
  3. Choose Full page photo from the layout list on the right — that is one picture per page. Untick Fit picture to frame if you would rather not have the edges cropped, then press Print and save the file.

One image per page, please — a picture of a two-page spread is read as a single page and lands next to the wrong neighbour when the book opens in double-page mode. Portrait images at around 150 dpi are plenty for screen. A PDF built from pictures carries no text, so the reader's search finds nothing printed inside them. Then upload the PDF as in How to create a flipbook from a PDF.

Photographs make large files. If the combined PDF is over 150 MB, see How to generate a PDF catalog for how to compress it.

Don’t have a PDF catalog yet? Two ways to make one

Have Catalog Maker build one from your Shopify products, or lay it out yourself in Canva, Slides or InDesign.

CatalogZine starts from a PDF you supply — it does not build one. There are two practical ways to get one, and the first is far quicker when the catalog is made of products you already sell.

1. Build it from your Shopify products

Catalog Maker by EasyCatalog makes the PDF for you. Point it at a collection or pick products by hand, and it lays out the pages — titles, images, prices, variants, metafields — then exports a PDF you upload here. Line sheets and wholesale order forms are on the free tier; B2B pricing and Canva editing start at Basic. It is by aleksovApps, the same team as CatalogZine. Its free tier stores one catalog and watermarks some pages, so a clean export needs a paid plan — those start at $9.99 a month.

Install Catalog MakerSee what it does first

How to create a catalog from products or a collection walks the whole round trip, from a collection to a flipbook with working Add to cart buttons.

2. Lay it out yourself

Canva, Google Slides, Adobe InDesign and Affinity Publisher all export PDFs. Canva and Google Slides are the quickest if you have never laid out a page before; both have multi-page templates you can drop product photos into. Set the document to portrait, keep one catalog page per document page, and export at the end — the settings that matter are in How to generate a PDF catalog.

Pictures you already have work too. Product shots, a supplier's line sheet, or scans of a printed catalog can be combined into a PDF on your own computer in a couple of minutes: see How to create a flipbook from images.

However you get there, the layout is yours. CatalogZine adds nothing to your pages — no cover, no contents, no ordering or contact page. If you want those, put them in the PDF. A working contents page is possible once it is uploaded: draw a Link element over each entry, set Links to to Another page in this catalog, and choose the page it jumps to.

Leave a little room around anything you plan to make tappable. Buttons are drawn on top of your artwork in the editor, and a price sitting hard against a product photo leaves nowhere to put one without covering something.

How to add a flipbook to a store page

Press Embed to have the app make the page, or add the Catalog flipbook block to a page you already have.

There are two routes. Use Embed if the book needs a page of its own; use the theme block if it belongs on a page you already have.

Let the app make the page

On Catalogs, press Embed in the catalog's row. The app creates a published page on your online store with the book in it, and the dialog gives you View page and Edit in Shopify. Pressing Embed again later reuses that same page — it never makes a second one — so any copy you have written around the book is safe.

The first time, you may see One permission is missing. The app needs permission to add pages to your store, which shops that installed CatalogZine earlier have not granted. Press Reconnect the app once and your catalogs and settings are untouched.

Put it on a page you already have

  1. In CatalogZine, press Copy link in the catalog's row. The block takes that whole share link, or just the ID at the end of it — cat_6l1b1vwawte27zeaiykvdcom.
  2. Go to Online StoreThemesCustomize.
  3. Choose the page from the template menu at the top of the editor.
  4. Press Add block, open Apps, and pick Catalog flipbook. Some themes list it under Add sectionApps instead.
  5. Paste the link, or the ID, into Catalog ID or link.
  6. Set Heading, Shape on desktop, Maximum width, Space above and below, Corner radius and Background to taste, then Save.

Leave Load only when scrolled into view on unless the catalog is the first thing on the page. On a phone, and in a narrow column, the book is always portrait so a single page fills it, whatever shape you picked.

The Embed dialog shows the same ID in a Catalog ID box, but pressing Embed creates the storefront page above as well — so use Copy link if the ID is all you want. For a blog post, a Custom Liquid section, or a site that is not Shopify, that dialog also has Copy embed code. In Shopify's page editor the code must go in the HTML view — the rich text view strips it.

How to add a flipbook to a product or collection page

Add the Catalog flipbook app block to your product or collection template, or use Custom Liquid as a fallback.

Product and collection pages take the same theme block as any other page. You add it to the template, so it appears on every product or every collection that uses that template.

  1. In CatalogZine, press Copy link on the catalog. The block takes the share link, or the cat_ ID at the end of it.
  2. Go to Online StoreThemesCustomize.
  3. From the template menu at the top, choose ProductsDefault product, or CollectionsDefault collection.
  4. Press Add block in the section where you want the book, open Apps, and pick Catalog flipbook.
  5. Paste the link, or the ID, into Catalog ID or link, then drag the block up or down to position it.
  6. Press Save.

If only some products should show it, make a second product template — from the template menu in the theme editor, or in Online StoreThemesEdit code — add the block to that one, and assign it to those products in the product's Theme template setting.

App blocks need an Online Store 2.0 theme, and the section you are adding to has to accept blocks. If Apps is missing or empty where you expect it, try a different section on the page. If the theme refuses everywhere, add a Custom Liquid section instead and paste the embed code from the Embed dialog into it.

If you would rather not give the book space on the page, turn on the Catalog launcher app embed under App embeds in the theme editor and paste the same link or ID into its Catalog ID or link box — nothing renders until that box holds a catalog. It adds a floating button that opens the book in a lightbox. You can turn Show the floating button off and open the lightbox from your own button instead by adding data-catalogzine-open to it.

How to create a catalog from products or a collection

CatalogZine does not build the PDF — Catalog Maker does. Here is the round trip from a collection to a shoppable flipbook.

CatalogZine does not generate a catalog from your products; it starts from a PDF. The app that does generate one is Catalog Maker by EasyCatalog, by the same team — and the two together take you from a collection to a flipbook customers can buy from.

Catalog Maker by EasyCatalog builds the PDF out of your Shopify products. Point it at a collection or pick products by hand and it lays out titles, images, prices, variants and metafields for you. Its free tier stores one catalog and watermarks some pages, so a clean export needs a paid plan — those start at $9.99 a month.

Install Catalog MakerHow the two apps fit together

The round trip

  1. In Catalog Maker, choose the collection or the products you want, and export the catalog as a PDF.
  2. Upload that PDF on the Catalogs page here, as in How to create a flipbook from a PDF.
  3. In the editor, place an Add to cart element over each product. In the sidebar, search by product title, pick the product from the results, and if it has more than one variant choose the right one from the Variant list.
  4. Press Save, then Copy link to share it or Embed to put it on your store.

Linking is the fast part. The search reads your live catalogue, so a title you half-remember is enough — it lists the first 15 matches, so a narrow word beats a broad one — and the price comes across with the product. Add to cart takes a shopper straight to checkout with that variant in the bag, in a new tab; use Product hotspot instead when they should land on the product page and choose for themselves.

If you would rather lay it out by hand

Export your product list from the Shopify admin — Products, filter to the collection you want, then Export as CSV — and work from that in Canva, Google Slides, InDesign or Affinity Publisher, pulling images from ContentFiles. How to generate a PDF catalog has the export settings that matter.

The Products column on the catalog list counts the different products you have linked with Add to cart and Product hotspot elements, so you can see at a glance which catalogs are still unfinished.

How to generate a PDF catalog

Have Catalog Maker generate it, or export your own: single pages, portrait, 150 dpi, under 150 MB.

There are two answers, depending on where the catalog comes from.

Have it generated from your products

CatalogZine does not generate PDFs. Catalog Maker by EasyCatalog does — it builds the catalog from your Shopify products and exports a PDF you upload here directly. Same team as CatalogZine. Its free tier stores one catalog and watermarks some pages, so a clean export needs a paid plan — those start at $9.99 a month. If an upload is refused or the pages pair up oddly, the settings below are the ones to check.

Install Catalog MakerWhat it does

Or export one from a design tool

If you laid the catalog out yourself, a handful of export settings decide whether the flipbook reads well.

SettingWhat to use
PagesSingle pages, not spreads. The viewer pairs pages itself; a PDF of spreads gives you a book with four pages showing at once.
OrientationPortrait, and the same size on every page.
Resolution150 dpi is plenty for screen. Doubling it to 300 quadruples the pixels for detail nobody sees.
FontsEmbed them, or your type is substituted on the reader's machine.
File sizeUnder 150 MB.

Where the export lives

  • CanvaShareDownloadPDF Standard. Leave Flatten PDF off: it turns your text into a picture, and the flipbook's search reads the text in the PDF.
  • Google SlidesFileDownloadPDF document (.pdf). There is no portrait preset, so set the size first in FilePage setupCustom, taller than it is wide.
  • InDesignFileExportAdobe PDF, with Pages selected rather than Spreads.
  • Affinity PublisherFileExportPDF, with Area set to All Pages rather than All Spreads.

If the file is too big

On macOS, open it in Preview and use FileExport with the Reduce File Size Quartz filter. In Acrobat, use Compress a PDF, or FileSave as OtherReduced Size PDF in older versions. Smallpdf and similar web tools do the same job in a browser. Check a page of small type afterwards — heavy compression softens text before it softens photographs.

The page count matters as well as the size: 2000 pages is the ceiling. A catalog that long is better split into several, one per season or range.

Features

How to customize the flipbook viewer

One settings page controls every catalog in your shop: background, toolbar buttons, page turn and wording.

Open Flipbook settings in the CatalogZine navigation. There is one settings document per shop, so what you change here applies to every catalog you have uploaded and every one you upload later. There is no per-catalog styling.

  1. Pick a tab: Appearance, The book, Toolbar, Reading, Sharing, Wording or Advanced. The number beside a tab counts the settings on it that differ from the shipped default.
  2. Change a setting and watch the preview beside the form.
  3. Press Save in the bar that appears at the top. Discard puts everything back.

What each tab holds:

  • Appearance — what sits behind the book, which is either transparent or a solid colour; a background image, which covers that colour if you add one; your logo and the address it links to; the viewer height; and the space around the pages.
  • The book — book style, one page or two, reading direction, the 3D page turn, cover and shadow, and page turn speed (700ms by default).
  • Toolbar — every reader button gets one of three places: On the toolbar, In the More menu or Hidden. Download the PDF and Print start Hidden; Search, Contents, Thumbnails, zoom, full screen and the page number start on the toolbar. You can also move the toolbar above the book or hide it, and set the page-turn sound.
  • Reading — what clicking a page, the arrow keys and the mouse wheel do, the zoom step, and whether the catalog turns its own pages.
  • Sharing — the share button, and which networks it offers.
  • Wording — every word the viewer says, in your wording or another language.
  • Advanced — picture quality, and putting everything back the way it shipped.
Open full size, in the page header, opens your newest catalog in a new tab so you can judge it at full width. It shows your saved settings, not the ones you are still editing, and it appears only once you have uploaded a catalog.
The logo sits inside the toolbar. Setting the toolbar position to Hidden hides the logo with it — the page warns you when you have both.

How to turn off the page flip sound

It is already off. Where the setting lives, and the sound button readers get in the More menu.

It is already off. Page turns are silent on a new shop, and stay silent until someone changes the setting.

The setting is in Flipbook settingsToolbar tab, at the bottom, called Page-turn sound. It has three values:

  • Silent, with a sound button in the More menu — the default. No audio, and a reader who wants it can switch it on for themselves.
  • Silent, with no sound button — no audio and no button at all.
  • Page-turn sound on, with a button to mute it — audio from the first turn, and a button to stop it.

The reader's own control is in the toolbar's More menu. Pressing it changes what that one reader hears for that visit; it does not change your setting and nobody else is affected.

If you can hear page turns, one of two things has happened: the setting above has been changed to Page-turn sound on, or you pressed that sound button yourself on this device.

Catalog extra pages: welcome, about, ordering, contents

Welcome and ordering pages go in your own PDF. Here is how to make a contents page clickable.

CatalogZine does not add pages to a catalog. A welcome page, an about page, ordering information and a contents page are pages you put in the PDF yourself, in whatever you used to make it, before you upload. The flipbook shows the file you gave it and nothing else.

What the app adds is the clicking. Turn a printed contents page into a working one like this:

  1. Open the catalog on Catalogs and go to the contents page.
  2. Pick Link in the palette and drag a box over the first contents line.
  3. In the sidebar, set Links to to Another page in this catalog and choose the page from the list.
  4. Set the button style to Invisible. It paints nothing, so your printed line shows through and only the tap target is added.
  5. Press Cmd/Ctrl+D to duplicate it for the next line, drag the copy into place, and change the page it points at.
  6. Save, then Preview.

The same link type works anywhere: a "see page 12" note in the middle of a spread, or a back-to-contents button on every page.

Readers also get the toolbar's Thumbnails button, and a Contents button when your PDF carries bookmarks of its own — a PDF without them gets no Contents button, whatever the setting says. Where those sit is up to you, under Flipbook settings › Toolbar.
The PDF inside a catalog cannot be swapped. If you add pages later, upload the new PDF as a new catalog: it gets its own link, and its elements have to be placed again.

Manage uploaded files in app storage

Your PDF lives in CatalogZine's storage; images you place on pages live in your own Shopify Files.

Two stores, in two places, and they behave differently.

The PDF

The file you upload lives in CatalogZine's own storage. It is not in your Shopify Files and there is nothing to manage for it in the Shopify admin. Delete on the Catalogs row removes the catalog, the PDF and its cover image together. That is the only way to remove it, and it cannot be undone — the share link starts returning "not found" straight away. A PDF may be up to 150 MB and 2000 pages.

Images you place on pages

An Image element is served from your own Shopify Files. When you add one you either upload it — which puts it into your Files — or pick one already there. So:

  • Manage them in the Shopify admin under Content › Files, alongside everything else your shop uses.
  • They stay in your Files after you delete the catalog. Removing them is your call, not ours.
Deleting a file under Content › Files breaks it everywhere it is used, including on a catalog page, where the image will simply stop loading. Check where an image is used before you remove it.

The storefront page

If you pressed Embed, deleting the catalog also hides the Online Store page that was created for it. The page is hidden, not deleted, because you may have written your own copy around the book. Find it under Online Store › Pages in the Shopify admin to publish it again or delete it for good.

Advanced

Show different flipbooks based on purchase status

The app has no gating. Tag the customer, then choose which embed to show with Liquid in a Custom Liquid section.

CatalogZine has no customer gating. It does not know who is looking at a flipbook, and nothing in the app is restricted by customer, tag or order history. You do this in your theme, around the embed code, with Liquid.

The recipe is: tag the buyer, then show one catalog or the other depending on that tag.

  1. Tag the buyer. In the Shopify admin go to Customers, open the customer and add the tag wholesale. To do it automatically, use Shopify Flow with a trigger on order creation.
  2. In CatalogZine open Catalogs and press Embed on each catalog — the button reads Embed again once that catalog has a page — then press Copy embed code. Keep both snippets to hand.
  3. Go to Online StoreThemesCustomize, open the page you want the book on, then Add sectionCustom Liquid.
  4. Paste the Liquid below, with each embed code in the branch it belongs to, and save.
{% if customer and customer.tags contains 'wholesale' %}
  <!-- embed code for the wholesale catalog -->
{% else %}
  <!-- embed code for the retail catalog -->
{% endif %}

Use {% if customer %} on its own to show a book to signed-in customers only. Drop the {% else %} branch and everyone else sees nothing.

A customer's tags are readable only while that customer is signed in. A wholesale buyer who has not logged in gets the retail branch, so put a line on the page telling them to log in for trade pricing.
This hides a book from a casual visitor. It is not a security control. The share link, https://catalogzine.com/book/cat_…, still opens for anyone who has it: it is unlisted and carries a noindex tag, but it is not protected. Embed also leaves each book on a published page of your store — hide that page under Online StorePages if it should not be public, and note that pressing Embed again to re-copy the code publishes it once more. Do not put pricing in a flipbook that must not leak.

Wholesale line sheets and pricing

One catalog per price list, prices as labels on buttons, and where the real wholesale pricing has to live.

A line sheet is a catalog like any other: upload the trade PDF as its own catalog and give it its own hotspots. A hotspot map belongs to one catalog, so a retail book and a trade book cannot share one. CatalogZine does not build a line sheet for you — it starts from a PDF. Catalog Maker does build them, and Line Sheets is on its free tier.

Catalog Maker by EasyCatalog generates line sheets and wholesale order forms from your Shopify products, with B2B pricing from its Basic plan. Export the PDF, then bring it here for the tappable part. Its free tier stores one catalog and watermarks some pages, so a clean export needs a paid plan — those start at $9.99 a month.

Install Catalog MakerHow the two apps fit together

Showing a trade price

There are two places a number can appear. The first is your own artwork, printed in the PDF. The second is the button: select a cart, product or link element and set AppearanceText, up to 40 characters — for example Add — £18.00 trade. That field is shown only while Style is Solid, Outline or Soft; Icon only and Invisible draw no text at all. A cart element also has a Catalog price field under the linked product, described in the editor as shown instead of the store price.

Any price you type in the editor is a label. A cart button is a variant permalink, so the cart charges whatever that variant costs on your shop, and it adds one of that variant. To actually charge wholesale, set the prices in Shopify — a B2B catalog or a market price list — and treat the flipbook as the presentation layer over it.

Price grids and order forms

Line sheets usually print a grid of sizes and prices in the artwork. Set Style to Invisible on those elements: an invisible button paints nothing, so you can drop a transparent tap target over each row without covering the printing underneath. The editor marks them with a faint dashed outline so you can still find them; customers see nothing.

There is no order form and no quantity field. Each button adds one unit and the buyer changes quantities in the cart.

To keep the trade book away from retail shoppers, put it on a page gated by a customer tag — see Show different flipbooks based on purchase status.

How to open a flipbook from any element on your storefront

How the trigger works: one delegated listener, the attribute rules, the JavaScript API, and JavaScript-off behaviour.

The launcher binds one click listener to the document and, on every click, looks for the nearest ancestor carrying data-catalogzine-open. It never scans your markup at load time, so a trigger works even if it did not exist when the page loaded — inside a quick view, a cart drawer, a section that renders later, or markup another app injects. The copy-paste recipes are in Open the flipbook lightbox from custom links and buttons.

What the attribute accepts

  • No value: opens the catalog set in the Catalog launcher app embed.
  • A value must look like a catalog ID — cat_ followed by letters, digits, - or _. Anything else is ignored and the element behaves normally, so a link with a mistyped ID just follows its href.
  • Several triggers on one page can each name a different catalog. The lightbox swaps the book when the ID changes.
  • Only the ID travels. The address is built from the app embed's own settings, so a trigger cannot aim the lightbox at another site.
  • Hovering a trigger opens the connection to catalogzine.com early, so the first click has less to wait for.

From your own JavaScript

CatalogZine.open('cat_6l1b1vwawte27zeaiykvdcom');
CatalogZine.open();   // the catalog set in the app embed
CatalogZine.close();

Esc closes the lightbox, so does a click on the dimmed area, and focus returns to the element that opened it. The book loads on the first open and is kept afterwards, so reopening it is instant. If it has not appeared after twelve seconds, a link to open it in a new tab is shown.

The Catalog launcher app embed has to be enabled, with a valid catalog ID, or there is no lightbox: clicks do nothing and links follow their href. It also has to render on the page you are on — Show on starts at All pages except cart, so a trigger on the cart page needs that changed to All pages. Turning Show the floating button off is fine — the block still loads. The same applies with JavaScript off, which is why a trigger should be a real link wherever it can be.

Reference

Direct link, app block, embed code — which to use?

Five ways to show the same book — share link, Shopify page, theme block, embed code, launcher — and when each fits.

All of these show the same book, with the same hotspots and the same flipbook settings. What differs is where it appears and who has to set it up.

WayWhat it isWhere it worksWho sets it upPick it when
Share linkThe catalog's own page on catalogzine.com. Copy link in the Catalogs table.Anywhere a link goes: email, a message, a QR code, a menu item in your theme.Nobody. It works the moment the PDF is uploaded.You are sending the catalog to someone rather than putting it on the store.
Shopify pageA real Online Store page on your shop with the book in it, created by Embed and published.Your storefront, under your own domain.The app, in one press.You want the catalog on the store and would rather not open the theme editor.
Theme app blockThe Catalog flipbook block: heading, shape, maximum width, spacing, corner radius, background.Any template, in any section that takes blocks.You, in Customize > Add block > Apps.The book belongs inside a page you already have, sized to your layout.
Embed codeThe iframe markup from the Embed dialog. Copy embed code.Anywhere HTML is accepted: a blog post, a Custom Liquid section, a site that is not Shopify.You, by pasting.Nothing else reaches the spot you want it in.
Launcher lightboxThe Catalog launcher app embed: a floating button that opens the book over the page.All pages, all pages except cart, or the home page only.You, in the theme editor under App embeds. It is off until you turn it on.The catalog should be reachable from everywhere without owning a page of its own.

The two theme blocks need the catalog ID. It is in the app under Catalogs > Embed, in the dialog above the embed code: cat_ followed by 24 characters. Both blocks also accept a whole share link and take the ID out of it — so if you do not want the store page that Embed creates, press Copy link instead and paste the link into the block.

With the launcher enabled you can also open the book from your own markup: any element carrying data-catalogzine-open opens the lightbox, and a catalog ID as its value opens a different book. The floating button can be switched off while the rest keeps working. Your own triggers work only on the pages the launcher itself renders on, so keep Show on wide enough to cover them.

The share link is unlisted and the page carries noindex, so search engines do not list it. It is not secret: anyone with the link can open it.

Plan differences and limits

There are no paid plans and nothing is gated; these are the technical limits instead.

There are no paid plans. Nothing in CatalogZine is gated: every feature is available on every install, there is no cap on how many catalogs you upload, and no catalog carries a watermark. The limits below are technical ceilings, identical on every shop.

LimitValueWhat happens
File typePDF onlyThe upload is rejected unless both the detected file type and the .pdf extension say PDF.
File size150 MB per PDFA larger file is refused before the upload starts, in a message naming the file and the 150 MB ceiling.
Pages2000 per catalogHotspots are stored for pages 1 to 2000, and a page-jump link cannot point past page 2000.
Hotspots5000 per catalogA save that goes over is refused with “This catalog has too many hotspots.”
Button text40 charactersAnything longer is cut to 40 when it is saved.
Catalog name120 charactersLonger names are refused when you rename, and trimmed when taken from the filename.
Images20 MB, JPEG, PNG, GIF or WebPImage elements come from your own Shopify Files (Content > Files), and 20 MB is Shopify's cap on a file, not ours.
VideoYouTube onlyA video element stores the YouTube ID and nothing else. There is no video upload and no other host.

The PDF itself never goes into Shopify Files, for the same 20 MB reason — catalogs routinely exceed it — so the 150 MB ceiling is ours and the 20 MB one applies only to images you place on a page.

If a PDF is over 150 MB, export it again at a lower image quality, or split it into two catalogs and link one to the other with a link element. There is no way to raise the limit from inside the app.

Why the storefront doesn’t match the preview

The handful of reasons the book on your store can look different from the one you saw in the app.

It is the same book and the same file in both places. When the storefront looks different, it is nearly always one of these.

  • The settings are not saved yet. The live preview on Flipbook settings shows the values you are typing; the storefront shows the values you have saved. Press Save in the bar at the top. Open full size, at the top of that page, always shows the saved settings, so it is the honest check.
  • The hotspots are not saved yet. Preview in the hotspot editor holds a blank tab until the save lands, so that tab is correct — but a storefront page you already had open still shows what it loaded. Reload it.
  • Reduced motion is switched on. The viewer turns off every animation for a visitor whose system asks to reduce motion. The editor keeps animating on purpose, so a button that pulses while you place it is deliberately still for that visitor — including you, on your own machine, if you have the setting on.
  • The theme is deciding the width. Maximum width on the app block is a ceiling, not a width: a narrow section or a theme with its own page width will make the book smaller than you set. Put the block in a full-width section if you need the space.
  • The browser is showing an old copy. Storefront pages are cached hard. Reload the page, or open it in a private window, before assuming a change did not land.
  • The page is not published. Embed publishes the page it creates and republishes one that was hidden, but deleting a catalog hides its page, and anyone with admin access can unpublish it. Check Online Store > Pages in the Shopify admin.
  • A phone is showing two pages side by side. The viewer opens a single page only when its box is narrower than 768px and taller than about 1.1 times its width. The app block and the copied embed code both switch to a tall 5:7 box on a narrow screen; a hand-written iframe with a short fixed height does not, and gets a spread at postage-stamp size.
  • The iframe has no height at all. Then it is not a difference, it is broken — see Troubleshooting.

Troubleshooting

Symptom, cause and fix for the things that actually go wrong.

SymptomCauseFix
The book is a thin dark sliver.The iframe has no height, so the browser gives it its 150px default. The book fills the box it is given and never pushes it open.Paste the embed code whole, including the <div> around the iframe — that is the part that sets the height. Or use the Catalog flipbook block.
The fullscreen button does nothing.A hand-written iframe without allow="fullscreen". The request is blocked and the button fails silently.Copy the embed code from Catalogs > Embed and use it as it is; it carries the attribute.
No hotspots appear on the storefront.The editor was never saved, or the storefront page was loaded before the save.Open the catalog, save, then reload the storefront page.
One element is missing, the rest are there.It paints nothing. The area button style is a transparent tap target by design, and an image with no file, a video with no link, or a link with no destination is not drawn at all.Open it in the editor and give it a style, or a destination.
Embed says a permission is missing.Your shop installed the app before it could create pages, and Shopify does not ask for a new permission on its own.Press Reconnect the app in that dialog. Your catalogs and settings are untouched.
Catalog flipbook is not under Add block > Apps.The theme is a vintage theme, or the section you are in does not accept app blocks.Add it to a section that does, or paste the embed code into a Custom Liquid section.
The embed code disappeared from a Shopify page.It was pasted into the rich text view, which strips it.Paste it in the page editor's HTML view instead.
The block says “Add your catalog ID on the right to show the flipbook.”The setting is empty, or holds something that is not a catalog ID — a storefront URL, for example. The block paints nothing on the storefront rather than framing the wrong site, and says this in the theme editor instead.Paste the ID from Catalogs > Embed, or the whole share link.
The book is blank in a frame on a custom domain.The iframe's src is not a catalogzine.com book link — usually hand-typed, shortened or redirected.Copy the embed code again. The src must be https://catalogzine.com/book/ followed by the catalog ID.
If the book works but looks wrong rather than broken, the causes are different — see Why the storefront doesn’t match the preview.

Still stuck?

Email perica.aleksov@gmail.com with your store address and the catalog you are working on. If something in the app is broken, say what you clicked and what happened — that is usually enough to reproduce it.