Emergency situation

In case of emergencies or breakdowns, you can send an SMS to our emergency hotline

On-call phone (SMS only)

+45 29 70 15 95

Send an SMS with the following information:

  • Your name and webshop
  • Description of the problem
  • Your callback phone number

Notes: This service is only for critical situations where your webshop is down or has serious problems. For regular support, please use our normal support channels.

All support articles

Attach PDF to products

How to attach PDF files such as product sheets, manuals, datasheets or certificates to your products in Shoporama. Including example of correct display in the theme.

Reading time: approx. {eight} minutes
Shopejer Developer

You can attach PDF files directly to your products in Shoporama. This is ideal for product sheets, user manuals, safety data sheets, warranty certificates, assembly instructions or CE certificates. The files are displayed as download links on the product page so the customer can open or download them with one click.

How to attach a PDF

  1. Go to Products and click Edit on the product you want to add a PDF to.
  2. Find the Files section (typically just below images).
  3. Click Upload and select your PDF file from your computer.
  4. The file name is used as link text on the product page. Therefore, give it a descriptive file name (e.g. Instructions for use.pdf) before uploading.
  5. Click Save.

You can attach multiple files per product. They will appear in the order they are uploaded.

Tip: Name the files something the customer can understand immediately, e.g. manual.pdf, datasheet.pdf or assembly instructions.pdf. The file name is what the customer sees as a clickable link.

Display on the product page

On the product page, each PDF is displayed as a download link. The customer clicks on the link and the file is opened in the browser or downloaded to the computer. The link text is the file name and the URL points to the public path to the file. Note that where and how the files are displayed depends on your theme.

Download PDF files in your theme (for developers)

On a SafeProduct object, get the PDF files with getPdfFiles(). The method returns a list of SafeProductFile objects. On each object you have:

  • getFilename() - the name of the file (used as link text)
  • getUrl() - the public URL of the file
  • getMB() - file size in megabytes
  • getBytes() - file size in bytes

Example of Smarty code in a product template:

<{if $product->getPdfFiles()}> <ul class="product-files"> <{foreach $product->getPdfFiles() as $file}> <li> <a href="<{$file->getUrl()}>" target="_blank" rel="noopener"> <{$file->getFilename()}> <span class="file-size">(<{$file->getMB()|string_format:"%.2f"}>MB)</span> </a> </li> <{/foreach}> </ul> <{/if}>

Note: Use getPdfFiles() - not getFiles(). And use getFilename() as link text. There is no getTitle() method on SafeProductFile, so give the files meaningful names before uploading to make the link nice and understandable.

Tips for neat PDF attachments

  • Use short, descriptive file names without spaces and without an asterisk (e.g. manual.pdf or datasheet.pdf).
  • Compress large PDF files for fast downloading on mobile. Many print PDFs can be cut to a third without any visible loss of quality.
  • Check that the file can be opened on both desktop and mobile before uploading.
  • Keep content up to date, such as CE marking, certifications and contact information.
  • Add the same type of file in the same language (Danish vs. English) so the customer knows what they are downloading.

Other file types and digital products

The file field on products is specific to PDFs via getPdfFiles(). If you sell digital products, such as e-books, audio files or images that need to be downloaded after purchase, use downloadable products instead. Read more in the article Sell downloadable products.

Tip: If you want to attach a file to the order confirmation email instead (e.g. general terms and conditions or a small instruction manual), you can do so in the online shop settings. See Attach file to order confirmation.

Frequently asked questions

How big can the PDF file be?

There is no fixed limit in admin, but the larger the file, the longer it takes for the customer to download it, especially on mobile. Feel free to compress files over 5 MB. Many print PDFs can be reduced to a third of the size without any visible loss of quality.

Can the customer download the PDF without being logged in?

Yes, they can. PDFs attached via the file field on a product are publicly available on the product page. If the file should only be available after purchase (e.g. an e-book), use downloadable products instead.

Can I attach the same PDF to multiple products?

You need to upload the file per product. If it's the same PDF (e.g. a combined brochure for a product series), you can choose to hardcode a common link in the theme instead of going through the product files.

Where do I find the button to upload the PDF?

Inside the individual product under Products, scroll down to the Files section. This is typically located just below the product images section. Click Upload and select the PDF from your computer.

What happens if I upload a file with the same name again?

The file gets a new unique name on the server, so the new version is next to the old one. Delete the old file in admin if you want to clean up so the customer only sees the latest one.

Can I control the order of the PDF files on the product page?

The files are shown in the order they are uploaded. If you want to change the order, you can delete a file and upload it again so that it goes last. Alternatively, your developer can sort them in the theme with Smarty.

Do PDFs count against my storage space?

PDFs of products are stored on Shoporama's servers as part of your store. There is plenty of space for normal use. If you have a large product database with heavy documents, contact us so we can assess your setup.

Can PDFs be found via Google?

Yes, they can. PDFs on your webshop can be indexed by Google and show up in search results. This is a good reason to give the files nice, search-friendly names. If you want to avoid indexing a specific file, you can block it in your robots.txt.

Are there accounting requirements for datasheets and certificates?

Safety data sheets and CE certificates belong to the product documentation itself, not the accounts. Keep them up to date with the supplier's latest version to meet legal requirements for customers and authorities. The actual invoice to the customer is controlled via the PDF invoice settings.

Can I bulk import PDFs for many products?

Yes, via the REST API you can upload files programmatically and link them to a product. This is useful if you have many products with datasheets from one supplier. Read more in the REST API documentation.

Do you need help? Contact us at support@shoporama.dk.

Related articles

Sell downloadable products

Guide to selling digital downloadable products (PDF, audio, video, ZIP, etc.) in Shoporama. How the download link works, what the customer sees...

Attach file to the order confirmation

Guide to attaching a file (e.g. terms and conditions) to the order confirmation in Shoporama.

Edit product

Guide to the product editing page in Shoporama. Review of all sections: general, descriptions, images, categories, labels, stock, profiles,...

REST API documentation

Link to documentation for Shoporama's REST API for integration with external systems.

Attach terms and conditions to the order confirmation

Guide to attaching terms and conditions as a PDF to the order confirmation in your Shoporama online shop.