Embedded viewer
Show PDFs directly on the page with full navigation controls.
This page covers both:
- PDF Embedded Viewer (linked PDFs)
- PDF Embedded Manual (manual URLs in theme settings)
What the embedded viewer does
The embedded viewer displays your PDF right on the page. Customers can read, scroll, zoom, and navigate pages without leaving your store.
PDF viewer configuration
For the linked block (PDF Embedded Viewer), choose viewer type in the app's PDF details page under Viewer Configuration.
For the manual block (PDF Embedded Manual), choose viewer type in the block settings inside theme editor.
Available viewer types:
Custom Viewer (Full Featured)
- Full-featured PDF viewer with all navigation controls
- Search functionality, zoom tools, customizable display options
- Mobile-optimized viewing
- Configure: Initial page, zoom level, page layout, scroll direction
- Enable/disable: Download, toolbar, image stamps, highlighter, drawing tools, text selection
Light Viewer (Fast & Simple)
- Simple, fast-loading viewer with minimal interface
- Perfect for quick document preview
- Mobile-optimized
- No configuration options - just works
Flipbook Viewer (Interactive Pages)
- Interactive page-flipping experience
- Mimics reading a physical book or magazine
- Great for catalogs, brochures, marketing materials
- Not mobile-optimized
- Configure: Animation style, page shadows, background color
Native Browser Viewer (Standard)
- Uses browser-native PDF rendering
- No extra viewer scripts
- Most lightweight option
- Behavior can vary slightly by browser
For linked PDFs, the chosen viewer applies across all places that PDF is shown. For manual blocks, the chosen viewer applies to all URLs entered in that manual block.
How it looks
The embedded viewer displays the PDF directly on the page using your chosen viewer configuration:
Custom Viewer shows:
- Full PDF content with navigation toolbar
- Page controls (previous/next, zoom)
- Search functionality
- Download/print buttons (if enabled)
- Customizable features based on your settings
Light Viewer shows:
- Simple PDF display
- Basic navigation
- Minimal interface for fast loading
Flipbook Viewer shows:
- Page-flipping animation
- Book-like reading experience
- Interactive page turns
When to use embedded viewer
Best for:
- Long documents customers should read on your site
- Technical specs that need zooming
- Catalogs where browsing is important
- Pages with room for the viewer
- Desktop-focused content
Not ideal for:
- Short PDFs (use button instead)
- Mobile-first stores (can be cramped)
- Pages with limited space
- When you have many PDFs on one page
Add embedded viewer to your theme
- Go to Online Store > Themes
- Click Customize on your active theme
- Navigate to the page where you want PDFs to appear
- Click Add section or Add block
- Find PDF Connect under Apps
- Select PDF Embedded Viewer
- Click Save
To use manual mode instead, add PDF Embedded Manual and paste one or multiple URLs in block settings.
Customize the embedded extension
In the theme editor, you can customize how the embedded viewer appears on your page:
Show heading - Toggle section heading on/off
Heading text - Customize the section title (e.g., "PDF Documents")
Viewer height - Set height as percentage of viewport (desktop only, mobile uses full screen)
Show container border - Add border around the viewer
These settings control the extension layout and styling only. The actual PDF viewer features (zoom, download, toolbar, navigation, etc.) are configured in the app's Viewer Configuration section for each PDF.
For PDF Embedded Manual, viewer features are configured in the block settings (no linked PDF required).
Multiple PDFs with embedded viewer
If you link multiple PDFs to one page, the embedded viewer shows them stacked vertically:
- First PDF displays in first viewer
- Second PDF displays in second viewer
- Customers scroll down to see each one
This can make pages very long. Consider using button display for multiple PDFs instead.
Embedded viewer on mobile
The viewer adapts to mobile screens but:
- Takes up significant vertical space
- Zoom controls can be small
- Scrolling inside the viewer can be tricky
- Consider using button display for mobile-first stores
Viewer features
Zoom - Customers can zoom in and out
Page navigation - Jump to specific pages
Search - Find text within the PDF (some viewers)
Download - Save PDF to their device (if enabled)
Print - Print directly from the viewer (if enabled)
Performance tips
Optimize PDF size - Files under 5MB load fastest
Lazy loading - Viewer loads only when visible on page
Thumbnail quality - First page loads before full PDF
Mobile consideration - Larger files may load slowly on mobile data