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.

Video: a customer uploads a PDF, its first page becomes a high-resolution image and is placed on the tumbler
First page of an uploaded PDF placed on the canvas
First page of an uploaded PDF placed on the canvas

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

  1. Install the addon (free)

    Download the free PDF Upload ZIP from your Veyo account — no purchase needed.

  2. Upload it in the Veyo Apps screen

    Open Veyo → Extensions and upload the ZIP. Veyo verifies the package and installs it.

  3. Enable it

    Toggle PDF Upload on. PDF becomes an accepted file type in the designer's upload panel automatically.

How to use PDF Upload

  1. Customer uploads a PDF

    In the upload panel, the customer selects a PDF file instead of an image.

  2. First page renders as an image

    Veyo renders the first page to a high-resolution image entirely in the browser.

  3. Continues like any upload

    The resulting image behaves like a normal upload — it can be cropped, filtered, positioned, and resized.

At a glance

Version1.1.3
PlatformsWordPress, OpenCart, PrestaShop and Shopware 6. It is designer-only: it runs in the shopper's browser with no server code.
RequiresVeyo Product Personalizer 1.4.0 or later. No other addon is required.
Where settings liveNowhere: the addon has no settings screen. Install it and enable it in Extensions.
Server tools / outside servicesNone. 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).
Designer upload panel accepting a PDF file
Screenshot: the designer upload panel after choosing a PDF

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:

SettingDefaultRange / optionsWhat it does
Pages importedFirst page onlyFixedPages after the first are ignored.
Render resolution300 dpiFixed, capped so the longest side is at most 4096 pixelsA page that would be larger than 4096 px on its longest side is scaled down to fit. Small pages render at 300 dpi.
Output formatPNGFixedThe 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 dist folder and retries from a second path if the first fails. If both fail (for example a security plugin or server rule blocks .mjs files), 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.