Freedam Picker
Choose assets from Freedam inside any web app
Add a “Choose from Freedam” button to your CMS, online shop or internal tool. People search the library, pick an approved image, video or document, and your app receives a published URL instead of a copied file.
Freedam
A popup, a tab, a modal or a panel in your page
The picker opens where it suits your app: in a separate window, in a new browser tab, over the page, or inside a sidebar or form. The WordPress plugin opens it in a new tab. It is the Freedam library in a lighter layout, with the same search, filters, collections and favorites.
People sign in with their usual Freedam account, including single sign-on, and only see the assets their permissions allow. The picker is available in English, French, German, Spanish, Brazilian Portuguese and Simplified Chinese.
Published URLs in the size you need
The asset stays in Freedam. Your page shows a stable URL from a publication channel, so a new version of the image replaces the old one everywhere without changing the link.
Your templates ask for the size they need: a named format of the channel, or any width and height. Freedam crops around the asset’s focus point, which is detected on upload and can be moved with a click. Browsers get AVIF or WebP when they support it.
Videos and documents, ready to embed
A video arrives with the Freedam player, served by the channel. Before inserting it, people set autoplay, sound, loop, controls, the start time and the default subtitle track. Apps with their own player get the adaptive stream and the poster.
A data sheet, catalog or presentation is inserted as a download link, a clickable thumbnail or a page-by-page viewer, as the original file or as a PDF. When the document is updated in Freedam, every page that links to it shows the new version.
Upload without leaving the page
A web editor who receives new photos from an agency uploads them from the picker, up to 20 at a time. They go to the collection the profile sets, with the title taken from the file name, a suggested alt text and the credit remembered from the last upload.
Each file can be inserted once Freedam has processed it. Approval workflows still apply, and Freedam records who uploaded the file and from which integration.
Usage tracking and rights expiry
Each insertion is recorded on the asset, with the integration, the person and the date. Your app can add the page URL or a product reference, and remove the usage when the asset leaves the page. Before anyone deletes or unpublishes an asset, Freedam lists where it is used.
Assets with expired usage rights never appear in the picker. When rights expire on an asset already in use, its published URLs stop serving it within five minutes, and the player and the viewer show that the content is unavailable.
Administrators see how often each integration opens the picker, which assets are inserted most, the searches that found nothing, and the expired assets still declared in use, with a CSV export of each view.
You decide who opens it and what it offers
An administrator creates one integration per website or app, links it to a publication channel and copies the snippet from the console.
Allowed origins
Each integration lists the websites that may open the picker. The picker refuses any other origin and only sends a selection back to the page that opened it.
A profile per audience
A profile sets which assets are offered, with a rule on collections, types, metadata or workflow status. By default it offers approved assets. It also sets the metadata returned and whether people may upload.
Access without an account
An agency or a tool without Freedam users opens the picker with the integration’s public key. It reads only what the profile offers, and you can revoke it at any time.
Ready for WordPress
The Freedam plugin adds a Freedam tab to the WordPress media library. The assets people choose become media library items served by the publication channel, and the Image block, the featured image and the gallery use them like any other image.
How the WordPress plugin worksReady for Shopify
The Freedam app for Shopify opens the picker from a product page, with the search filled in with the product's SKU. The chosen images become product media, Freedam records every product that uses them, and the app removes an image when its rights end.
How the Shopify app worksA few lines of JavaScript
The SDK opens the picker and returns the chosen assets. The playground lets you set every option and see the picker, the payload and the generated code side by side.
- One script from your workspace, the npm package @freedam/picker, or the <freedam-picker> web component
- No runtime dependency, a few kilobytes, TypeScript types included
- Each asset comes back with its URLs, focus point, dimensions and the metadata the profile exposes
- Usages are updated with a token from the payload, so no backend is required
import { open } from '@freedam/picker';
button.addEventListener('click', async () => {
const assets = await open({
workspace: 'acme.freedam.io',
integration: 'int_8f3k2',
mode: 'modal',
});
image.src = assets?.[0].url;
});Included in the Business plan
Start free. Includes 30 days of every paid feature. No credit card required.
Curious how yours would look? Generate a brand center from your website, free, in about a minute.