Documentation · FolderBloom

Getting started

Create an account and add a site with its domain (for example example.com).
Connect Dropbox or OneDrive. FolderBloom asks for read-only access.
Create a library by choosing a folder. Only that folder and its subfolders are published.
Create an embed, pick a layout and theme, and check the live preview.
Buy the site license ($60/year), verify the domain, and paste the snippet into your page.

Install the embed

Paste this where the library should appear. It loads asynchronously, has no dependencies and mounts an isolated frame, so your theme's CSS won't interfere:

<script src="https://folderbloom.com/embed.js" data-embed-id="fb_your_embed_id" async></script>

Prefer a placeholder? Add <div data-folderbloom="fb_your_embed_id"></div> anywhere and include the script once. Optional attributes: data-title (accessible frame title), data-height (initial height in px) and data-loading="eager" for above-the-fold embeds.

WordPress

Install the FolderBloom Embed plugin (included in the download as wordpress/folderbloom-embed) and use the shortcode [folderbloom id="fb_your_embed_id"]. Or paste the snippet into a Custom HTML block — both use the same hosted library.

Webflow, Squarespace, Wix and others

Add an Embed / Code / Custom HTML element and paste the snippet. Some builders only run scripts on the published site, so check the live page rather than the editor preview.

Verify your domain

Choose whichever you can edit:

DNS: add a TXT record on _folderbloom.example.com (or the root) with the value shown in the dashboard.
HTML file: upload a text file to https://example.com/.well-known/folderbloom-verification.txt containing the value shown.

www.example.com and example.com are one site. You can also allow one staging origin; localhost always works for previews. Changing a verified domain requires verifying the new one and is limited to once every 30 days (support can help sooner).

Stable file links

Every file has a link like https://folderbloom.com/f/abc123…. Copy it from Libraries. It keeps working when you save a new version over the file, rename it, or move it within the published folder. Deleting a file retires the link — it shows “no longer available” and never points at another file. If a delete-and-re-upload looks like the same document, the file appears under Needs review so you can reconnect the link or keep them separate.

Protected folders

In Access, set a password on any folder in a library. Visitors see it as locked; nothing inside is listed, searchable or downloadable until they enter the password. Subfolders inherit protection unless you mark one public. Rotating the password signs everyone out. Unlocks last two hours per browser session.

Galleries

Add a gallery tier to the site, create a library of kind “Gallery”, and choose a gallery layout. FolderBloom builds AVIF/WebP images at 480, 960 and 1600 px wide (never larger than the original) plus a JPEG fallback, stripping EXIF location data. Captions and alt text can be edited per image.

Analytics

A download is counted when FolderBloom starts sending the file (a “download start”), since completion can't be measured reliably. Data is kept for about 13 months. Export any range as CSV.

Billing & licensing

Each site has its own annual subscription. A failed renewal starts a 14-day grace period during which embeds keep working. A cancelled subscription works until the paid year ends. After that, embeds show a small unavailable message. Manage payment methods and invoices through the billing portal.

Troubleshooting

“Not enabled for this website” — the page's domain doesn't match the site's verified domain or staging origin.
“Temporarily unavailable” — the site's license isn't active. Check Billing.
Files not updating — open Connections; if it says “Reconnect”, sign in to the provider again. Use “Sync now” on the library.
Content Security Policy on your site — allow https://folderbloom.com in script-src and frame-src.