To add a PDF to Squarespace as a download, put a link on any text, button or image, choose File in the link editor, upload the PDF (20 MB limit), switch on “Open in new tab”, and save; visitors click and the PDF opens or downloads. To display the PDF on the page instead, so it can be read without leaving, you embed it in a Code block with an iframe or an Issuu-style viewer, which needs the Core plan or higher. Those are the two jobs, and most “how to add a PDF” confusion is not knowing which one you want. Both are below, with the file management panel where uploads live, the direct-link URL you can share or put in a QR code, how to make a PDF a paid or gated download, and why a PDF is often the wrong format for the content in it.
How to add a PDF to Squarespace as a download link
- Highlight the text in a text block (or edit a button or image’s link) and click the link icon.
- In the link editor choose File.
- Click the upload icon and pick the PDF, or search for one already uploaded under Recently uploaded.
- Switch Open link in new tab on so the PDF does not replace your page.
- Save. The link now points at the file’s Squarespace URL.
Squarespace’s file upload guide sets the 20 MB per-file limit and notes that PDFs open in the browser by default while some types (.docx) download. The same File option exists in navigation links, so a “Menu” or “Price list” item in the main menu can open a PDF directly; it also exists in cover page actions on 7.0.
Where do uploaded files live, and what is the direct URL?
Every file uploaded through a link editor is stored on the site and listed in that editor’s file picker; hover over a file for rename and delete. The URL looks like https://yourdomain.com/s/your-file.pdf, and it works on its own: paste it into an email, a social post or a QR code and it opens the PDF without a page around it. Two cautions, the first from Squarespace’s own docs: a file you delete stays on the CDN at its old URL for a while, so do not rely on deletion to unpublish something sensitive; and, from experience, re-uploading a file with the same name does not replace the old one, it creates a second file, so update the link.
How do you embed a PDF so it displays on the page?
| Method | Plan | How | Notes |
|---|---|---|---|
| Direct iframe | Core or higher (Code block) | Code block with the file URL in an iframe | Works in most desktop browsers; on phones, some show a download prompt instead of the viewer |
| Google Drive viewer | Core or higher | Upload to Drive, share as anyone with link, use the /preview embed URL in an iframe | Reliable on mobile; Google branding |
| Issuu or FlippingBook | Core or higher | Upload there, paste their embed code in a Code block | Page-flip presentation; the free tiers carry ads or limits |
| Image of each page | Any plan | Export pages as JPGs, add as image blocks | No plan requirement, fully responsive, not selectable text |
The direct iframe:
<iframe src="https://yourdomain.com/s/your-file.pdf" width="100%" height="800" style="border:0;"></iframe>
<p><a href="https://yourdomain.com/s/your-file.pdf" target="_blank">Download the PDF</a></p>Always add the download link under the embed, because Squarespace’s file display guide warns that embeds can misbehave on small screens, and a PDF viewer inside a 375-pixel phone is rarely readable anyway.
How do you make a PDF a paid or gated download?
- Paid: add a Digital product in a store page and upload the PDF as the file; Squarespace delivers a download link after checkout. Digital product fees vary by plan.
- Email-gated (a lead magnet): a Newsletter block or form with the confirmation page or auto-reply containing the file link. Squarespace Email Campaigns can send the link automatically; with Mailchimp, use its welcome email.
- Members only: put the download link on a page inside a Member Site (paid or free membership).
- Password: a page password on the page holding the link. Note that the file URL itself is not password-protected; anyone with the direct link can open it.
That last point matters for anything confidential: Squarespace file URLs are public if known. Client files, contracts and pricing you do not want indexed belong behind a real login, or shared from Drive with restricted access. The form file upload post covers the reverse direction, where visitors send you files.
Should the content be a PDF at all?
| Content | Better as | Why |
|---|---|---|
| Restaurant menu | A page | Google indexes it; readable on phones; updated in place without a new file |
| Price list | A page or a section | Same; a PDF price list is out of date within months and cached in email |
| Service brochure | Service pages | The whole point of the site is the brochure |
| Portfolio or lookbook | Gallery pages, or a flipbook embed if print layout matters | Faster, indexable |
| Forms clients fill in | A Form block | No printing, no scanning, submissions stored |
| Genuinely printable documents: guides, worksheets, certificates, spec sheets, legal terms | A PDF | Print layout and fixed formatting are the point |
Google indexes PDF text, but a PDF ranks worse than a page with the same content, is slow on mobile and cannot carry your navigation or a button. If the PDF exists because the content was already in a PDF, put it on a page and offer the PDF as a secondary download; adding keywords to Squarespace pages covers how that page then gets found.
Why is the PDF link not working?
- Opens a blank tab or downloads instead of showing: browser behaviour; both are normal. Add “(PDF)” to the link text so visitors expect it.
- Old version keeps opening: the re-upload created a new file; point the link at the new one, or expect caching for a few minutes.
- Over 20 MB: compress the PDF (export at 150 dpi for screen; most 40 MB brochures drop to 4 MB), or host it on Drive.
- Embed shows nothing on mobile: expected for iframes; keep the download link beneath.
- Link gives 404: the file was deleted, or the URL was edited by hand; re-link from the file picker.
Files are a small part of a Squarespace build and a frequent source of support emails afterwards, which is why the handover on my projects includes the one-minute link-editor walkthrough and a rule of thumb: pages for anything that changes, PDFs for anything that prints.
Frequently asked questions
Add a link to text, a button, an image or a navigation item, choose File in the link editor, upload the PDF (20 MB limit), switch on Open in new tab and save. The file gets a URL at /s/filename.pdf that also works on its own.
On the Core plan or higher, add a Code block with an iframe pointing at the PDF’s URL (or a Google Drive preview link), and put a download link beneath it for phones. On lower plans, add the pages as images.
Yes. A file link is free on every plan. To charge for a PDF, add it as a Digital product in a store page; to gate it behind an email address, deliver the link through a newsletter confirmation or auto-reply.
No. Anything uploaded through the link editor is reachable by its URL, and deleted files can remain on the CDN for a time. Put confidential files behind a Member Site or share them from a restricted Drive folder.
Files are capped at 20 MB. Export the PDF for screen (150 dpi, compressed images) which usually cuts brochures to a few MB, or host it on Google Drive and link to it.
Better as a page: Google indexes it, it reads on phones, and you update it in place. Offer a PDF as a secondary download only if people need to print it.
