Home › Docs › Addons › PDF Upload
PDF Upload
Free Import the first page of a PDF as a high-resolution image in the designer.
Platforms: WooCommerce, OpenCart, PrestaShop & Shopware 6. Version: 1.1.3.
Every purchase is a single signed, install-ready ZIP that also includes full TypeScript/Vue source, sourcemaps, and build tooling (npm ci && npm run build) if you want to customize it yourself. Installs and updates through the in-app addon marketplace.
What PDF Upload does
PDF Upload lets customers upload a PDF and imports its first page as a high-resolution image layer, dropping straight into the normal image-upload flow afterward — a must-have for WooCommerce shops taking pre-made artwork from business customers who only have a PDF proof.
Rendering happens entirely in the browser using PDF.js, loaded lazily so it adds no weight for shops that don't use it — no PDF data is ever sent to the server.
How to enable PDF Upload
-
Install the addon (free)
Download the free PDF Upload ZIP from your Veyo account — no purchase needed.
-
Upload it in the Veyo Apps screen
Open Veyo → Extensions and upload the ZIP. Veyo verifies the package and installs it.
-
Enable it
Toggle PDF Upload on. PDF becomes an accepted file type in the designer's upload panel automatically.
How to use PDF Upload
-
Customer uploads a PDF
In the upload panel, the customer selects a PDF file instead of an image.
-
First page renders as an image
Veyo renders the first page to a high-resolution image entirely in the browser.
-
Continues like any upload
The resulting image behaves like a normal upload — it can be cropped, filtered, positioned, and resized.
At a glance
| Version | 1.1.3 |
|---|---|
| Platforms | WordPress, OpenCart, PrestaShop and Shopware 6. It is designer-only: it runs in the shopper's browser with no server code. |
| Requires | Veyo Product Personalizer 1.4.0 or later. No other addon is required. |
| Where settings live | Nowhere: the addon has no settings screen. Install it and enable it in Extensions. |
| Server tools / outside services | None. The PDF is rendered in the shopper's browser with PDF.js, which is bundled inside the addon and loaded from your own site (no CDN). |
What shoppers see
PDF becomes an accepted file type (.pdf or application/pdf) in the designer's normal upload flow. The shopper picks a PDF as they would pick a picture; the first page is rendered and handed on as a PNG image with the same name (proof.pdf becomes proof.png). From there it behaves like any uploaded image, see The designer.
- If the PDF has more than one page, an info notice First page imported is shown. A one-page PDF imports silently.
- If the file cannot be read, the error Could not read PDF is shown and nothing is added to the design.
Settings
There are no settings. The behavior is fixed in the addon:
| Setting | Default | Range / options | What it does |
|---|---|---|---|
| Pages imported | First page only | Fixed | Pages after the first are ignored. |
| Render resolution | 300 dpi | Fixed, capped so the longest side is at most 4096 pixels | A page that would be larger than 4096 px on its longest side is scaled down to fit. Small pages render at 300 dpi. |
| Output format | PNG | Fixed | The rendered page is a PNG image. |
What you get in orders and production
The addon adds nothing to orders by itself. The customer's design contains the rendered PNG as an ordinary image layer, so it appears in the order and in your production files exactly like any other uploaded picture. The original PDF is not kept, because it never leaves the shopper's browser. See Orders & production files. Because the page is turned into a raster image, any vector artwork or live text inside the PDF is not preserved as vectors.
Data and privacy
- Database tables and options: none. The addon stores nothing.
- Outside services: none. PDF.js and its worker file ship inside the addon.
- Shopper data: the PDF is read in the browser and is never sent to your server or to Veyo. Only the rendered PNG enters the design, and is then handled by the normal upload flow.
- Uninstalling the addon removes its files and has no data to keep or delete. Uninstalling the whole of Veyo is unaffected by it. See Uninstalling & your data.
Troubleshooting
- The upload panel still rejects PDFs. Check that PDF Upload is installed and enabled in Extensions, and that your core Veyo version is 1.4.0 or later. See Install addons.
- "Could not read PDF". The browser could not render the file. Try re-exporting it from the original application, or save the artwork as a PNG or JPG instead.
- The PDF worker file cannot be loaded. The addon loads PDF.js's worker from its own
distfolder and retries from a second path if the first fails. If both fail (for example a security plugin or server rule blocks.mjsfiles), allow that folder to be served. - Only the first page appears. This is by design; export the page you need as its own PDF.
- The image looks soft on a very large page. Pages are capped at 4096 px on the longest side, so a large-format PDF is rendered below 300 dpi.
FAQ
Does the PDF ever get uploaded to the server?
No — rendering happens client-side; only the resulting rendered image is used going forward.
What if the PDF has multiple pages?
Only the first page is imported. Customers with multi-page artwork should export the specific page they need as a PDF first.
Installing, updating and removing
- Install: upload the ZIP in Extensions, then enable it. See Install addons.
- Update: upload the newer ZIP over the old one. Settings and data are kept. See Upgrading.
- Remove: Uninstall on the addon card removes its files and keeps its data, so reinstalling restores everything. See Uninstalling & your data.