{"id":750,"date":"2026-08-05T17:45:56","date_gmt":"2026-08-05T17:45:56","guid":{"rendered":"https:\/\/documentlibrary.pro\/?post_type=doc&p=750"},"modified":"2026-08-05T18:05:34","modified_gmt":"2026-08-05T18:05:34","slug":"download-buttons-not-working","status":"publish","type":"doc","link":"https:\/\/documentlibrary.pro\/es\/docs\/download-buttons-not-working\/","title":{"rendered":"The download buttons don’t work in my embedded document library"},"content":{"rendered":"

If your document library works perfectly on its own page, but the Download<\/strong> (and sometimes Vista previa<\/strong>) buttons do nothing once you embed it on another website, this article explains why and what to do about it.<\/p>\n

What’s happening<\/h2>\n

Some website platforms load embedded content inside a sandboxed<\/em> iframe — a locked-down container that the web browser deliberately prevents from doing certain things, including downloading files. When your document library is placed inside one of these sandboxes, the browser silently blocks the download, so the button appears to do nothing.<\/p>\n

Preview can be affected too: by default the preview opens in a new browser tab, and the same sandbox also blocks new tabs from opening.<\/p>\n

This is a restriction imposed by the hosting platform and enforced by the browser — it isn’t a fault in Document Library Pro. The identical library downloads perfectly on its own URL, and on any platform that doesn’t sandbox embeds.<\/p>\n

Wix<\/strong> is the most common example: both of Wix’s embed options (“Embed HTML\/Code” and “Embed a Site”) wrap your library in a sandbox that doesn’t permit downloads.<\/p>\n

How to confirm this is the cause<\/h2>\n

Please check this first, because if the symptoms are different it may be a separate issue that we can<\/em> fix for you:<\/p>\n

    \n
  1. Open the library’s direct URL.<\/strong> Copy the address from your embed code (for example https:\/\/your-library.documentlibrary.app\/?dlp_embed=1<\/code>) and open it in a new browser tab. Click Download. If it downloads fine there but not when embedded, the embedding sandbox is the cause.<\/li>\n
  2. Check the browser console (optional, technical).<\/strong> On the embedded page, open your browser’s developer console. A message such as “Download is disallowed. The frame… is sandboxed and the ‘allow-downloads’ permission is not set<\/em>” or ERR_BLOCKED_BY_CLIENT<\/code> confirms it.<\/li>\n<\/ol>\n

    If the file also<\/strong> fails to download from the direct URL, this is not<\/em> the sandbox issue — please contact support<\/a> and we’ll help you get to the bottom of it.<\/p>\n

    How to fix it<\/h2>\n

    Wix<\/h3>\n

    Install and use the Document Library Pro Wix app rather than pasting an embed code. The app adds your library as a native Wix element that isn’t sandboxed, so downloads and preview work normally. If you’ve pasted the embed code and are seeing this problem, please contact support<\/a> and we’ll help you switch over.<\/p>\n

    Self-hosted WordPress, Webflow, Framer, or plain HTML sites<\/h3>\n

    These don’t sandbox embeds, so the standard embed code works, downloads included. If you’re seeing the problem on one of these, it’s something else — please contact support<\/a>.<\/p>\n

    Other website builders (Squarespace, Notion, and similar)<\/h3>\n

    If the platform offers an official Document Library Pro app or integration, use that. If it only offers a generic “embed code” box and sandboxes it, downloads can’t be switched on from our side — but you can still let visitors view<\/strong> your documents (see below).<\/p>\n

    View-only option (works even inside a sandbox)<\/h3>\n

    If downloads can’t be enabled on your platform, you can still let visitors open and read documents in a viewer on the page. Simply turn off<\/strong> the download button in your library settings and leave the preview<\/strong> button on. Inside a sandbox, the preview automatically opens each document in a viewer on the page (rather than a new tab), so it works even where downloads don’t.<\/p>\n

    This works for PDFs and images<\/strong>. Word and Excel files can’t be displayed in a browser this way, so a view-only setup suits libraries made up of PDFs and images. If you’d like a hand setting this up, contact support<\/a>.<\/p>\n

    Still stuck?<\/h2>\n

    Get in touch via support<\/a> with your platform name and the page URL, and we’ll advise the best option for your particular setup.<\/p>","protected":false},"excerpt":{"rendered":"

    If your document library works perfectly on its own page, but the Download (and sometimes Preview) buttons do nothing once you embed it on another website, this article explains why and what to do about it. What’s happening Some website platforms load embedded content inside a sandboxed iframe — a locked-down container that the web […]<\/p>\n","protected":false},"menu_order":0,"template":"","meta":{"footnotes":""},"doc_category":[10],"class_list":["post-750","doc","type-doc","status-publish","hentry","doc_category-troubleshooting"],"yoast_head":"\nThe download buttons don't work in my embedded document library<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/documentlibrary.pro\/es\/docs\/download-buttons-not-working\/\" \/>\n<meta property=\"og:locale\" content=\"es_ES\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"The download buttons don't work in my embedded document library\" \/>\n<meta property=\"og:description\" content=\"If your document library works perfectly on its own page, but the Download (and sometimes Preview) buttons do nothing once you embed it on another website, this article explains why and what to do about it. What’s happening Some website platforms load embedded content inside a sandboxed iframe — a locked-down container that the web […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/documentlibrary.pro\/es\/docs\/download-buttons-not-working\/\" \/>\n<meta property=\"og:site_name\" content=\"Document Library Pro\" \/>\n<meta property=\"article:modified_time\" content=\"2026-08-05T18:05:34+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/docs\\\/download-buttons-not-working\\\/\",\"url\":\"https:\\\/\\\/documentlibrary.pro\\\/docs\\\/download-buttons-not-working\\\/\",\"name\":\"The download buttons don't work in my embedded document library\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/#website\"},\"datePublished\":\"2026-08-05T17:45:56+00:00\",\"dateModified\":\"2026-08-05T18:05:34+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/docs\\\/download-buttons-not-working\\\/#breadcrumb\"},\"inLanguage\":\"es-ES\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/documentlibrary.pro\\\/docs\\\/download-buttons-not-working\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/docs\\\/download-buttons-not-working\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/documentlibrary.pro\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Docs\",\"item\":\"https:\\\/\\\/documentlibrary.pro\\\/docs\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"The download buttons don’t work in my embedded document library\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/#website\",\"url\":\"https:\\\/\\\/documentlibrary.pro\\\/\",\"name\":\"Document Library Pro\",\"description\":\"Searchable document libraries for any website\",\"publisher\":{\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/documentlibrary.pro\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"es-ES\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/#organization\",\"name\":\"Document Library Pro\",\"url\":\"https:\\\/\\\/documentlibrary.pro\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"es-ES\",\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/documentlibrary.pro\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/favicon-512.png\",\"contentUrl\":\"https:\\\/\\\/documentlibrary.pro\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/favicon-512.png\",\"width\":512,\"height\":512,\"caption\":\"Document Library Pro\"},\"image\":{\"@id\":\"https:\\\/\\\/documentlibrary.pro\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"description\":\"Document Library Pro is hosted document library software that lets you publish searchable, filterable libraries of PDFs, documents and resources on any website or platform.\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"The download buttons don't work in my embedded document library","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/documentlibrary.pro\/es\/docs\/download-buttons-not-working\/","og_locale":"es_ES","og_type":"article","og_title":"The download buttons don't work in my embedded document library","og_description":"If your document library works perfectly on its own page, but the Download (and sometimes Preview) buttons do nothing once you embed it on another website, this article explains why and what to do about it. What’s happening Some website platforms load embedded content inside a sandboxed iframe — a locked-down container that the web […]","og_url":"https:\/\/documentlibrary.pro\/es\/docs\/download-buttons-not-working\/","og_site_name":"Document Library Pro","article_modified_time":"2026-08-05T18:05:34+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/documentlibrary.pro\/docs\/download-buttons-not-working\/","url":"https:\/\/documentlibrary.pro\/docs\/download-buttons-not-working\/","name":"The download buttons don't work in my embedded document library","isPartOf":{"@id":"https:\/\/documentlibrary.pro\/#website"},"datePublished":"2026-08-05T17:45:56+00:00","dateModified":"2026-08-05T18:05:34+00:00","breadcrumb":{"@id":"https:\/\/documentlibrary.pro\/docs\/download-buttons-not-working\/#breadcrumb"},"inLanguage":"es-ES","potentialAction":[{"@type":"ReadAction","target":["https:\/\/documentlibrary.pro\/docs\/download-buttons-not-working\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/documentlibrary.pro\/docs\/download-buttons-not-working\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/documentlibrary.pro\/"},{"@type":"ListItem","position":2,"name":"Docs","item":"https:\/\/documentlibrary.pro\/docs\/"},{"@type":"ListItem","position":3,"name":"The download buttons don’t work in my embedded document library"}]},{"@type":"WebSite","@id":"https:\/\/documentlibrary.pro\/#website","url":"https:\/\/documentlibrary.pro\/","name":"Document Library Pro","description":"Bibliotecas de documentos con b\u00fasqueda para cualquier sitio web","publisher":{"@id":"https:\/\/documentlibrary.pro\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/documentlibrary.pro\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"es-ES"},{"@type":"Organization","@id":"https:\/\/documentlibrary.pro\/#organization","name":"Document Library Pro","url":"https:\/\/documentlibrary.pro\/","logo":{"@type":"ImageObject","inLanguage":"es-ES","@id":"https:\/\/documentlibrary.pro\/#\/schema\/logo\/image\/","url":"https:\/\/documentlibrary.pro\/wp-content\/uploads\/2026\/06\/favicon-512.png","contentUrl":"https:\/\/documentlibrary.pro\/wp-content\/uploads\/2026\/06\/favicon-512.png","width":512,"height":512,"caption":"Document Library Pro"},"image":{"@id":"https:\/\/documentlibrary.pro\/#\/schema\/logo\/image\/"},"description":"Document Library Pro es un software de biblioteca de documentos alojada que le permite publicar bibliotecas con b\u00fasqueda y filtros de PDF, documentos y recursos en cualquier sitio web o plataforma."}]}},"_links":{"self":[{"href":"https:\/\/documentlibrary.pro\/es\/wp-json\/wp\/v2\/doc\/750","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/documentlibrary.pro\/es\/wp-json\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/documentlibrary.pro\/es\/wp-json\/wp\/v2\/types\/doc"}],"version-history":[{"count":2,"href":"https:\/\/documentlibrary.pro\/es\/wp-json\/wp\/v2\/doc\/750\/revisions"}],"predecessor-version":[{"id":755,"href":"https:\/\/documentlibrary.pro\/es\/wp-json\/wp\/v2\/doc\/750\/revisions\/755"}],"wp:attachment":[{"href":"https:\/\/documentlibrary.pro\/es\/wp-json\/wp\/v2\/media?parent=750"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/documentlibrary.pro\/es\/wp-json\/wp\/v2\/doc_category?post=750"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}