Documentation
How to use freedam, from a first sign-in to the API. 109 pages for library users, workspace admins and developers.
Start here
Signing In
Sign in to your Freedam workspace with a password or single sign-on, reset a forgotten password, create an account, request access, and get an inactive account reactivated.
First Steps
Your first minutes in Freedam: accepting the terms of use, finding your way around, searching and downloading assets, and where to get help.
Workspace Setup
Create a Freedam workspace with a 30-day trial, follow the setup checklist, find your workspace again, and understand what happens when the trial ends.
API reference
Every endpoint of the public API, with its parameters and response schemas.
Features
For everyone who works in the library: find, organize, share and create assets.
Overview
Gallery & Search
- GalleryBrowse, search, and manage your digital assets with advanced filtering and bulk processing tools.
- Searching by KeywordFind assets by typing words from filenames, descriptions, tags, captions, and the text inside documents or images.
- Searching by MeaningFind assets based on what they show or describe, even when the exact keyword isn't anywhere in the metadata.
- Suggestions as You TypeGet live word and list-value suggestions as you type in the search bar.
- Did You Mean? (Spell-check)When you mistype a search term, Freedam proposes the closest real match from your library so you never hit a dead end.
- Filtering ResultsNarrow the Gallery to exactly the assets you need using quick filters for colour, tags, asset type, dates and more.
- Advanced FiltersBuild precise multi-rule queries that combine any number of conditions with AND / OR logic.
- Bulk Paste SearchPaste a list of SKUs, product references or other identifiers into a smart filter and find every matching asset in one step - plus export the values that didn't match. Optionally pin it as a one-click button next to the gallery search bar.
- Saved SearchesSave your favourite filters and searches so you can recall them in one click - useful for recurring reports and day-to-day tasks.
- Find Visually Similar ImagesUpload a reference image and find assets in the library that look like it - perfect for catching duplicates, variants, and on-brand alternatives.
- Finding Photos of a PersonLocate every photo in the library that features a given person - useful for talent management, approvals, and personalised communications.
- Bulk Metadata EditChange metadata on many assets at once with a queue of operations: set or clear values, find and replace, append or prepend text, shift dates, and add or remove keywords.
- ExportExport a selection of assets as a ZIP archive with a metadata spreadsheet, a PDF portfolio or contact sheet, or a CSV of their metadata.
Assets
- Asset DetailView, edit, and manage individual digital assets, including metadata, version history, and performance analytics.
- Download DialogChoose a size, answer what your administrator asks, sign the usage rights, or request access: everything that happens when you press Download on an asset.
- Video Poster & SubtitlesChoose the poster frame shown for a video asset (from auto-extracted candidates, an arbitrary timestamp, or an uploaded custom cover) and attach multilingual SRT/VTT subtitle tracks that play in the browser and feed full-text search.
- Video TranscriptsAutomatic speech-to-text transcripts for video and audio assets, with an in-browser editor, translations, multi-format downloads, and search indexing.
- Content CredentialsHow Freedam verifies C2PA Content Credentials on upload, flags AI-generated and camera-captured files, and lets you filter by provenance.
- CommentsDiscuss assets and collections with comments: reply in threads, mention colleagues with @ to notify them by email, edit or delete your comments, and resolve discussions.
- Faces and PeopleHow Freedam detects faces in images, how to name the people in them, identify the same person across many photos at once, and correct a wrong identification.
- Linked and Related AssetsSee the assets related to an asset, link assets by hand or by metadata, select them, find visually similar images and near-duplicates, duplicate an asset, and change its asset class.
- AttachmentsAttach supporting files such as model releases, contracts and source files to assets and collections, choose who can see them, and add them to many assets at once.
- RenderingsRenderings are alternative files attached to an asset, such as crops, translations and social media exports. Upload them, get them approved, and download them.
- Template GenerationGenerate branded images from templates or template sets for one or many assets, fill in text, adjust and regenerate, then save or download the results before drafts are deleted.
Collections
- CollectionsOrganize, manage, and reorder your digital assets into structured collections and sub-collections.
- Browsing the CatalogueBrowse collections like a shop: picture tiles, one page per level, a breadcrumb that moves up and sideways, and a search box.
- The Collection PageEverything on the page of one collection: cover, status line, Download all, Share, Add files, the toolbar, sections, Select and Arrange modes, the side panel, and why some actions are not offered.
- Managing the CatalogueFor people who may manage collections: create a collection at the right level, edit it from its tile, arrange a level, move a collection, and delete it.
- My CollectionsYour personal space for collections: shelves and folders, collections that colleagues shared with you, collections you follow, and Save to from anywhere in the catalogue.
Sharing
- Share LinksCreate share links for assets, selections and collections: public, email-restricted or password-protected access, download quality, watermarks, start and expiry dates, and managing links afterwards.
- Receiving a ShareWhat to do when someone shares Freedam assets with you: opening a protected link, browsing collections, searching, previewing, choosing a download size, downloading files or a ZIP, copying a video embed code, and contacting the sender.
Uploads
Studio
- StudioUse AI-powered tools to crop, resize, remove backgrounds, add brand overlays, relight, enhance, denoise and restyle your digital assets without leaving Freedam.
- Custom Studio SkillsDesign your own AI editing tools for Studio: write one prompt template, curate the options, and let your team generate on-brand visuals with a click.
AI Chat
Brand Portals
Integrations
Analytics
Sustainability
Account
- User SettingsManage your profile, interface and content languages, password, linked Google or Microsoft accounts, connected apps such as Canva, personal preferences, and account deactivation.
- SubscriptionManage your collection notification preferences and track updates for assets you follow.
- InvitationsManage and send email invitations to bring new members onto your Freedam platform.
- Sending FeedbackReport a bug or suggest an improvement to the Freedam team from any page, and what information is sent with your report.
Workflows
Administration
For workspace admins: users and access, the content model, rules, branding and system settings.
Overview
Users & Access
- UsersManage user accounts, assign system roles, monitor account status, and perform bulk user imports via CSV.
- User GroupsManage hierarchical user organizations, group memberships, and bulk email communications.
- Role ManagementCreate roles, set each permission to Inherit, Allow or Deny in one matrix, and look up what every permission allows and what else it needs.
- RightsManage ODRL-compliant rights policies to control asset usage, expiration, and legal acknowledgments.
- Rights LogsMonitor and audit all digital rights evaluations, acknowledgements, and asset downloads across your organization.
- User RequestsReview and manage registration and reactivation requests from new and returning users.
Content Model
- VocabulariesManage controlled taxonomies, flat lists, and multi-language terms used for asset metadata.
- Metadata DefinitionsConfigure and manage custom metadata fields, data types, and cascading vocabulary dependencies for specific asset classes.
- Asset ClassesDefine and manage asset categories, metadata structures, and automated workflow transitions for your digital library.
- Collection TypesDefine and manage the organizational structures, metadata schemas, and hierarchy levels for your digital asset collections.
- Custom PagesCreate and manage dynamic web pages using a drag-and-drop block editor with version control and workflow management.
- Page SpacesGroup custom pages into spaces, each with its own address, default language and theme, and arrange the page tree that defines its navigation.
- ThemesCreate visual themes for custom pages: colours, heading and body fonts, spacing, corners and shadows, a branded header, and a default cover image for the spaces that use them.
Rules
- Rules OverviewManage and audit all automation, collection, and asset access rules from a centralized rule catalog.
- Automation RulesAutomate asset processing by defining rules that trigger metadata updates, notifications, and workflow changes during ingestion or updates.
- Collection RulesAutomate asset organization by defining rules that automatically assign assets to collections based on metadata and file properties.
- Field RulesConfigure conditional logic to dynamically show, hide, require, or validate metadata fields based on user input.
- Filename Parsing RulesExtract structured metadata from uploaded filenames using regex patterns. Map captured groups to core asset fields or custom metadata fields, with AI-assisted pattern generation.
- Export Naming RulesBuild the filename used when assets are downloaded, shared, or zipped. Compose names from asset fields and custom metadata, with per-context targeting and live preview.
Workflows
Branding
Templates
- TemplatesCreate and manage responsive image generation templates with a visual drag-and-drop editor.
- Template SetsGroup and organize design templates into sets for efficient batch image generation and management.
- Form StudioDesign and test custom metadata form layouts for different asset classes using a drag-and-drop builder.
Access Policies
- Asset Access RulesConfigure dynamic visibility, preview, and download permissions for assets based on user attributes and asset metadata.
- Downloads by Asset TypeHow download resolution settings translate across images, videos, audio files, and documents.
- Asset RequestsReview and manage user requests for asset downloads and new rendition submissions.
- Public SharesMonitor and manage all external and internal shared content, track engagement analytics, and control access lifecycles.
- Access SettingsManage how users join your platform through invitations, self-registration, and Single Sign-On with Google or Microsoft.
- Public DAMOpen your gallery, collections, dashboard and brand guide to visitors without an account, while keeping full control over what they can see and download.
Search
AI
- AI SettingsConfigure AI providers, map operational models, and monitor usage costs and performance across the platform.
- Admin AssistantAsk the Admin Assistant about your workspace setup in plain language, let it check a form or diagnose access, and review, apply or undo the changes it proposes.
- Studio SkillsAuthor custom prompt-template Studio skills, enable or disable tools, and curate the order of the Studio tool rail.
Integrations
- API Keys & PlaygroundManage application tokens, monitor webhook health, and test API endpoints directly within the Freedam interface.
- MCP ServerConnect AI assistants like Claude and ChatGPT to your DAM using the Model Context Protocol to automate asset management tasks.
- Microsoft 365 CopilotShare approved images with Microsoft 365 Copilot and Microsoft Search, step by step, and keep them in sync with your library.
- Data SourcesConnect Freedam to external DAM systems, S3 buckets, and Google Drive for asset and catalog ingestion: one-off imports on every plan, scheduled refresh on the Business plan.
Analytics
Billing
Sustainability
System
- System SettingsConfigure system-wide parameters, operational limits, and manage configuration backups for the Freedam platform.
- Display DefaultsSet the gallery view, card metadata and list columns every user starts with, and push them to accounts that already customised their own.
- System HealthMonitor system performance, track background operations, and verify external service dependencies.
- LanguagesConfigure system-wide language availability and set the default language for all users.
- GlossaryTeach Freedam your brand names and jargon so transcripts spell them correctly and translations keep them verbatim or use your preferred wording.
- TrashManage deleted assets, restore files to their original locations, or permanently remove them from the system.
- Backups & Disaster RecoveryHow Freedam automatically protects your workspace data, files, and settings against loss - and what to do if you ever need a restore.
Legal
- AnnouncementsPublish a banner under the app header to everyone or to selected users, written in the interface languages and scheduled in advance.
- Terms of UseManage versioned legal agreements, user consent tracking, and compliance exports for your digital asset management platform.
- Third-Party LicensesView and manage the inventory of open-source PHP and JavaScript packages used to power the Freedam application.
API
For developers: authentication, endpoints, webhooks and the SDKs.
Overview
- API AuthenticationLearn how to authenticate with the Freedam API
- API EndpointsIndex of all v1 endpoints exposed by the Freedam API
- Rate LimitingPer-token request limits, response headers, and back-off behaviour for the Freedam API
- WebhooksSubscribe to real-time Freedam events with signed HTTP callbacks
- Official SDKsOfficial client libraries for the Freedam API and how to generate your own
- Image TransformationsRender Freedam-hosted images with the signed transform URLs returned by the API