Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Dedicated interface for viewing, managing, and updating financial information, transactions, and payment methods for subscribing services
This tab contains information about the plan and add-ons for the currently selected project.
This tab contains invoicing and payment information for the company.
The invoices page provides a comprehensive summary of both paid and pending invoices, offering the ability to download them for record-keeping and reference.
Filerobot is an AI-powered Digital Asset Management (DAM) platform with integrated image and video optimizers that stores, organizes, and accelerates media galleries online.
Filerobot can be implement either as or as a combination of:
for marketing, content and creative teams to upload, manage and transform marketing assets in one central source-of-truth
for organizing, optimizing and delivering millions of media assets via API and integrating into your tech stack easily
for providing a fast and modern upload experience and delivering media galleries on any web application
Filerobot is architected to scale and manage thousands to hundreds of millions of assets per customer tenant.
Filerobot is a modular platform build around 5 main components:
Through a variety of APIs, plugins and connectors, Filerobot is designed to be integrated in an ecosystem of 3rd party applications such as PIM, CMS, ERP, booking platforms, and more.
AI-powered uploads automatically tag assets for better classification, data enrichment and search while content moderation algorithms automate User-Generated Content (UGC) flows.
The FMAW offers advanced capabilities such as inline image editing, search, filtering, bulk management of tags and metadata.
It is an ideal solution for building interactive media upload and management experiences in your web or mobile applications.
These post-processing capabilities can be done in 2 ways:
Asynchronous processes allow you to avoid waiting for the process to complete during the upload
Synchronous processes empower you to validate assets based on pre-defined criteria
This versatile feature streamlines your asset management process to suit specific business needs.
Filerobot integrates 3 advanced image, video, and static file optimizers, empowering you to transform your media assets on-the-fly or through a background process after uploading.
Filerobot collaborates with numerous Content delivery Network (CDN) providers that boast an extensive global network of thousands of Points-of-Presence (PoP). This strategic partnership allows Filerobot to efficiently cache media assets as close as possible to the viewers, resulting in significantly faster loading times of assets regardless of the channel, device and user location.
The Filerobot token is a key concept to understand when working with Filerobot. It identifies your tenant, aka project.
Whether you need to enhance sharing and collaboration around media assets within siloed teams to increase productivity or manage millions of product images, videos and data sheets, Filerobot's multi-tenancy will enable you to address all use cases from a single pane of glass.
Single or multi-brand scenarios?
Single or multi-site setup?
Interactions between multiple internal and external teams as part of your Content
Operations?
Filerobot's scalable multi-tenancy will prevent asset duplication, save time in categorizing and retrieving assets and overall structure your media asset library to set your organization for success when it comes to building engaging and fast digital experiences.
Each tenant is called a Project identified by a Token ({token}
) in the DAM. A project hierarchy can be created with users and teams given various access permissions to a single or multiple projects.
Each new Filerobot account comes with a first token or project. Each project combines a storage container to store assets and a CDN distribution to deliver optimized assets over CDN all around the world.
Some system settings are project-specific while others are company specific.
Setting | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
: A scalable cloud-based file system to store and organize files across the globe
such as the , the , the and to offer multiple entry and media distribution points for content administrators, contributors and consumers
: AI-powered automations to enrich and moderate assets and generate variants
to transform and optimize images, videos and any static content on-the-fly and accelerate over CDN
A to accelerate asset loading times worldwide
Filerobot relies on a multi-tenant, scalable and flexible file system serving as foundation to an intuitive for enabling DAM workflows and integrations within your Content Operations.
Filerobot is designed to be the central Hub for all brand and product images, videos as well as static assets in your organization. The provides interfaces to your internal and external stakeholders to upload, categorize, collaborate and deliver fast and beautiful media assets via multiple channels to global audiences.
The is a versatile file uploader and media gallery seamlessly integrated into an easy-to-use modal or inline widget. As a window to the Filerobot DAM, it empowers users to enjoy accelerated uploads through Filerobot's robust content ingestion network and reverse CDN as well customizable galleries.
The is Filerobot's external sharing feature that allows to securely share multiple assets directly from the DAM with external parties. Select the files for sharing and create a password-protected Sharebox with optional password protection and expiration date. All active Shareboxes are accessible within the shared tab in the Asset Hub, allowing you to manage them in one place.
The grants external users to upload assets directly into specific folders in the DAM using public links. Password-protection and expiration date are optionally available.
is the hub running all Filerobot's ML and AI capabiltiies. Upon asset upload, ASK Filerobot intelligently extracts information from your media assets with AI and grants you the flexibility to initiate various tasks.
: Filerobot will save you hours in image processing tasks by manipulating and transforming your images, optimized for web delivery.
: Filerobot's adaptive streaming and video transcoding features ensure your videos load fast anywhere and on any device. Filerobot can transcode your videos in multiple target resolutions and generate the playlist (manifest) for your DASH or HLS video players.
: With the Filerobot CDN, Filerobot efficiently accelerates the delivery of all types of static content, including PDFs, CSS and JS minification.
As a simple rule, all settings are linked to the company, while all other settings such as or or are project-specific.
Users can be created at company level and thus access all company projects or at project-level to restrict their access to only specific projects. See for more details.
Plan overview
Describes the current plan being subscribed to
Purchased Add-ons
This is a list of all subscribed and activated Add-ons for the current plan
Available Add-ons
This is the list of additional add-ons that can be enabled
Billing address
Specify (or update) a billing address and contact email for invoicing
Invoice email
Add contacts who should receive copies of the invoices
Payment method
List of available payment methods for making payments on your invoices. You can only choose one option.
Payment method: Card
Once "CARD" is selected, you will be required to enter your card details, which will be used to make payments.
Payment method: Bank (manual)
Once "Bank (manual)" is selected, a bank transfer will be setup and used to make payments.
Payment method: Direct debit
Once "Direct debit" is selected, you will be required to enter your IBAN, which will be used to make payments.
Project-level settings
Company-wide settings applying to all projects
This page contains company-wide settings applying to all projects
This page section contains the key personal information about the user:
In this section, the user can specify the security settings company-wide
Configure SSO for users to log in with their corporate credentials (such as Active Directory, Okta or Azure AD / Entra ID) into Filerobot.
An Identity Provider supporting SAMLv2 is required.
To configure SAMLv2-based SSO, click on the Add SSO connection button. Any Identity Provider supporting the SAMLv2 protocol is supported.
After saving the SSO connection, every user attempting to log in with an email address from the domain configured in Step 3 will be redirected to the configured Identity Provider and automatically logged into the Asset Hub if an active SAMLv2 session is enabled.
Teams help organising users into groups and set team-based permissions on folders and assets
Authorized users can create teams with the button. Following fields are needed to create a team:
To manage team members, users can either:
Click on an existing team to show the team composition on the collapsible right side panel
Access the Manage members
option from the actions menu ...
Both options provides:
A list of existing team members with an option to remove them from the team (trash icon)
A link to add new members with their name / email either -- addition can be done one by one or in bulk
A search to quickly find an existing team member (first name, last name or email)
This section manages all users with Filerobot Asset Hub access
The Invite users modal is used to invite users where single or bulk invitation emails can be sent. Users can be created at the company level for access to all corporate projects or at the project level for access to a single or multiple projects.
The Asset Hub supports various user access levels, a.k.a. user level.
In addition to the standard levels mentioned above, administrators have the possibility to create up to 5 custom levels and define for each which pages and menu will be available
Custom project levels are available for company-wide and project users (they don't have access to company-related informations)
Users can only invite lower-level users, with the exception of project-level Managers, who can also invite Manager.
Email address
User level (see above)
Access scope:
Entire company
Project(s): select projects user should have access to
Once validated, an email invitation is sent to the user's email address.
A user can only manage lower-level users, e.g. a Viewer cannot manage a Manager.
The following attributes are available for editing:
User level
Active or inactive status
Access scope
It is also possible to create custom user attributes fields on top of the existing system fields (email, name..)
Control panel where users can manage profile information, login and security settings
Section | Fields |
---|
Configure the Asset Hub's menus
Setting | Description |
---|
Enable Products to activate the Product reference and Product position system metadata for each asset and categorize assets per product SKU and position in a carousel as well as the Products asset view page to view assets per Product reference.
Allow you to configure the order of pages in the main menu for all users of this project.
The full API documentation is availabe under .
General settings for metadata variants and upload constraints
Owner, Administrators and Managers can manage the metadata structure
- general settings for metadata variants and upload constraints
- detailed specification of the metadata fields per asset type
This tab contains general settings for metadata variants and upload constraints
Enabling this option will prevent users from uploading assets without specifying the required metadata.
The asset upload option does not apply to API uploads
Metadata variants enable alternative displays for the same asset attributes, e.g. language, currency, location, etc.
System variants (language, regional group...) are required for the system to run
Custom variants can be created by users by clicking on the Add variant button:
A variant can contain multiple options: each option is composed of an API key and a label
Please note the special case for Language system variants
The top most option will be the default language for metadata and tags
All language options are to be selected from a drop-down list of supported languages (Languages that supported by AI are indicated with an AI tag)
The language API keys are the ISO code of the language selected and can't be modified
This section allows the user to specify which metadata fields should be used for special system attributes and functionality, such as licence expiry.
To add a mapping, click on the Add mapping button:
Choose the system attribute to map a metadata field to, select a compliant metadata field from the drop-down and press Save.
Currently, only license expiry is available
If there are no suitable metadata fields, you can click on the Create new metadata field button, which will trigger the Add a metadata modal (restricting the options to the applicable ones) to create a suitable field.
This tab enables the configuration of all asset metadata fields for the organisation. It consists of 1 pre-defined group of fields (System fields) and an option for the users to create additional metadata groups and fields.
The user can:
Users can search either by field name or field API key.
The search is dynamic, activating after the user enters at least 2 characters.
The search also filters both system and custom fields.
Every asset must have the following metadata fields:
Title
Description
Both are of type Text and with applicable regional variant Language.
Set whether it’s Required or not
Update the Placeholder text
Update the Info tooltip text
Adding a new group
When the user clicks the + Add group button, a new custom group is immediately added to the bottom of the custom groups list and the screen is auto-scrolled to it.
The user can:
Rename the group
Delete the group
Add a field to the group
Managing an existing group
Edit a field
Delete a field
The user can:
Save any changes by clicking the Save button
Cancel the operation and any changes by clicking the X button
The user has the following options:
Visibility - ON / OFF toggle button whether to show the field in the public API response header.
Name - free text to enter the field’s name
API key - the key to store/retrieve the variation from the back-end
Info tooltip - free text providing helpful information about what’s expected as value for the added metadata field
Placeholder text stating: ”Helpful information to display on hover”
You can set the Regional variant of a metadata field on creation only - you cannot modify it later.
If the selected Type is single- or multi-select, then the Metadata variant is disabled (since those options are lists of predefined items)
Required - ON/OFF toggle whether this field needs to be populated for every asset in the organisation. If a custom-defined metadata field is configured to be "Required", it means that Filerobot will not save assets where this field has no value and will prompt the user to fill it in, in order to Save.
Add button - to create the field
Cancel button - to cancel the operation without saving anything
When the user chooses Select-one or Multi-select type for the metadata field, they have to provide one or more answer options with the following details per each:
state the option's API key
specify the option’s value
It is a good practice to not include special characters in the API key, to keep it simple and corresponding to its value.
Editing a group field
The following fields are not editable:
Type
Metadata variant
Setting | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
Parameter | Description |
---|---|
The user levels Owner and Administrator are only available for company-wide users as they have access to company-related information such as or
User level | Available menu |
---|
The user level determines which Asset Hub menu items are visible to a user. The user level does not govern the folders and assets a user can view or the permissions assigned to them. These accesses are controlled via the gallery role assigned via the modal.
Custom company levels are only available for company-wide users as they can have access to company-related information such as or
Individually or in bulk, new users can be added via the button. Following fields are needed to invite an user:
Setting | Description |
---|
Setting | Description |
---|
Field | Description |
---|
System attribute | Metadata field requirements |
---|
Thereafter, all assets with that field filled will be searchable and most importantly can be alerted on that (expiry) date. See on how to configure them.
The System fields appear in the Embedded metadata category. They cannot be deleted - as indicated by a padlock icon All other fields are custom-defined metadata and the users can create, edit or delete them.
a field by Name or Key
(reorder) custom groups (only)
- add and delete new groups, as well as add, reorder, edit and delete their fields.
Users cannot modify system fields, apart from:
Click on the button to:
Once fields are added, the user can do the following operations on them by clicking on theellipsis button:
When the user clicks the Organize button, the screen is refreshed, showing only the custom group names in rows, under an Organize groups section title:
Reorder the groups by clicking and dragging on the reorder icon
Type - drop-down field with the following options: Integer | Select-one | Multi-select | Text-area | Text | Date | Boolean. Please find details for them .
NB. If the user chooses Select-one or Multi-select as type, then they must populate the relevant below
Metadata variant - drop-down field to select any of the available
Editing a custom metadata field is similar to , with the following exceptions:
Name | Type | Description | Examples (used for) |
---|
Company name
The company name displayed in the upper left corner of the Asset Hub, unless a project logo has been uploaded under Branding
Default language
When a Default language is selected, it will be used for all users.
Please note that it can be changed individually in My Account by each user.
Multi-factor authentication
Enable or disable MFA for all company or company project users. The MFA Code will be sent via email. Please note that MFA is bypassed if SSO is enabled.
Single sign-on (SSO)
Configure SAMLv2-based SSO to enable users to access the Asset Hub using SSO via an Identity Provider (IdP).
Prompt new users to accept the company's Ts & Cs on first login
Enable or disable the requirement for users to accept the customizable T&Cs upon first login
Ts & Cs content
The custom text or HTML to display to users on their first login. Supports multiple languages.
Force all users to accept the new Ts & Cs
Modifying the content of Ts & Cs will create a new version. Enabling this setting will force users having already accepted the previous version of the Ts & Cs to accept the updated version upon next login.
Logo (optional)
HEIC, JPEG, PNG, or WebP, max size 5MB
Name (required)
Name of the team
Description (optional)
Free text
Theme | Select between Dark, Light and Custom theme. |
Color | Add your own color-hex code to override the Asset Hub's default colour. |
Default number format | Set the styling for the thousands and decimal separators in numbers that you want to enforce. |
Login page layout | Select the layout of the login page |
Background cover type | Select the background of the login page: color or an image |
Cover | Select a background image if you have selected the image option |
Color | Set a background color if you have selected the color option |
Enable / Disable toggle | Enables the optional Home landing page where users will land when logging into the Asset Hub. The Home page is a widget-based customizable page that promote specific assets, folders, collections, tags, ... and also displays usage statistic such as "Most downloaded asset". |
| The name of the variant |
| the key to store/retrieve the variation from the back-end |
| the name for the particular variation |
license expiry |
|
Short text | TEXT | Free text shown on 1 line. Does not accept line breaks. | Title |
Long text | TEXTAREA | Similar to TEXT but you can place inside longer text and paragraphs. | Description |
Boolean | BOOLEAN | True/False indicator. Note: In the Filerobot UI it is visualised as a check-box. | "Approved" or "Published" |
Date | DATE | Calendar date format. | Created at |
Number (integer) | INTEGER | Positive and rond number. Note: takes only digits. | Order number |
List (single value) | SELECT | List with pre-defined options, where only one can be selected. Note: should not be used for more than 100 options to chose from. | Country of origin |
List (multiple values) | MULTI-SELECT | List with predefined options, where multiple values can be selected. Note: should not be used for more than 100 options to chose from. | Markets |
Supertags | TAGS | Unlimited list of attributes added into a dynamic list that can be searched and augmented on the fly by users. | Customers |
URI-type attachment | URI | Link to an external (WWW) asset or resource Officially supported URI schemes are: - url (http://xx, https://xx, www.xx) - phone (tel:+xx) -email (mailto:xx) Other URI schemes will also function but are not documented | Privacy policy |
Asset-type attachment | ATTACHMENT | Attach an internal hub asset Can add up to 5 attachments per metadata -- all hub assets types (video, image, pdf..) are supported | Asset |
The CDN invalidation page allows users to invalidate images from the CDN and Filerobot resizing servers.
The CDN invalidation is accessible from Settings > Development > CDN invalidation
Invalidation allows to flush the CDN cache to refresh the assets with their latest version without changing the URL. By default, Filerobot invalidates older version when a new version is created in the Asset Hub. Hence manual invalidation is mostly needed for externally hosted assets.
This option on the Add invalidation form enables the user to request the invalidation of all assets or a subset of assets by asset path using the 'original' option.
Past invalidation details
Past invalidation requests can be viewed along with their status and details (follow the links to view the inventory of invalidated assets).
Coming soon!
Owner (company only) | All Hub pages & System Settings |
Administrator (company only) |
Accountant |
Manager |
|
Developper | All Hub pages System settings:
|
Contributor | No System Settings Hub:
|
Viewer | No System Settings Hub:
|
Project logo | Upload a project (or company) logo to be displayed on the top-left corner of the Asset Hub. |
Favicon | Upload a custom favicon to replace the default Filerobot favicon. |
Personal info |
|
Login info |
|
Multi-factor authentication |
|
Specify who and when should be alerted about important events, such as asset expiration, being tagged in comments, and others
The metadata field used for the notification (eg. "licence expiry") needs to be configured (mapped) first.
It can be done in Settings > Project > Metadata > (tab) Configuration > (section) Field mappings:
You can read more about them in #field-mappings.
When the option is enabled, user can set notification on asset expiry by completing the following information:
Unless otherwise specified, notifications are typically sent at 6am UTC
Upload management rules, default visibility & download
When enabled, the system will return success once the entire file has been transferred from the user's browser to the uploader infrastructure. The file might not be immediately for download as it has to complete the upload to the storage infrastructure.
Set a rule for naming the assets once uploaded. Possible options are:
Assign a random file name in UUID format
Keep original file name with random suffix
Keep original file name
When enabled, Filerobot will resize the images during the upload process to optimize storage and accelerate further actions such as image editing or variant creation
When enabled, share an Asset Gallery Explorer over a public link to external users.
Set the default CDN visibility for the root folder.
Public will publish all assets over CDN link
Private will make the assets only visible in the Asset Hub and Widget implementations. Folders can inherit or override the Root folder’s default CDN visibility.
Set a default gallery role for all users in the project.
When enabled, Asset Hub users will be required to accept the custom #consent-notice before being able to download an asset.
Provide the agreement text users should agree to in order to download an asset.
Applied when #download-consent is enabled
Custom routing rules allow you to rewrite URLs in order to match file paths and names in Filerobot thereby shortening public asset URLs.
Manage API keys for headless applications
API keys allow to call the Filerobot file management API and are suited for backend or headless application where no user context is needed and where the key is not exposed to the browser
Authentication against the Filerobot API is done with an API Secret Key available under Settings > Developers > API keys.
New API keys can be created with the button. On click, user will be requested to
Enter the API key description so it can be easily identified
Select the permissions to be attached with the API key (multi selection from the permissions list) -- these defines what the user will be able to do with the assets
API Permission | Description |
---|---|
Existing API keys can be managed individually or in bulk for status (Active <> Deactivate). The following settings can be edited:
Easy-to-use central source-of-truth your company's media assets
The short explainer video below is just an appetizer of all the DAM use cases you will be able to implement within the Asset Hub:
Learn all you need to know to get started with uploading and managing assets within the Asset Hub from:
through Manage assets,
Enrich assets with Metadata and Tags,
Organize assets in static Folders or dynamic Collections,
Search & find assets with #filters or complex #search queries,
Collaborate with assets between users and,
Share assets internally as well as externally to finally,
Download assets in various target formats
Upload assets in bulk from your local computer or various external sources
The Filerobot Uploader lets you upload assets in the DAM from a variety of sources:
Your device's storage, camera or screen
Web links
Third party sources like Google Drive, Dropbox, Instagram, and many others.
You can drag & drop, copy & paste or browse to the file's location to select it for upload:
You can transform your assets as part of the upload process.
Once you click the Upload button, a progress icon is shown on each asset, as well as an overall Progress bar underneath the Upload modal, showing the cumulative progress of all assets:
There are 3 possible end states and relevant actions:
Post processing, Webhooks & integrations
Automations allow applying automated actions (background removal, AI-tagging, detecting brand logos, etc.) to uploaded assets during or after the upload process, or sending the uploaded asset's metadata to an external API endpoint.
The Automation settings are accessible from Settings > Development > Automations
Post-processing includes the application of various verifications and enrichments to an asset on upload - e.g. detect if it's not safe for work, count faces in an image, remove image background and many others.
To add a post process, you can click on the "+ Add post process" button and select a post process from the list (See link to list below)
Remember that post-processes marked with a * require ASK Filerobot credits.
Please note that when marked "Unavailable", a post-process will not run and needs a preliminary activation. That happens with a request to our Support Team, and in the meantime, triggering will be prevented regardless of the configuration of the post-process.
Provided it is then available to your token, and your account has enough ASK credits to run it (when needed), the post-process will be applied to all uploads if the "Run on every upload" is set to "Enabled".
Refer to Upload post-processes for a list of available post processes.
Once a post process is selected, user is requested to set the following parameters:
Parameter | Description |
---|---|
Web-hooks allow to call a 3rd party web service upon specific triggers and send all asset data in the JSON body.
Defines when the Webhook will be triggered
Defines which data is sent to the webhook
Turning files into assets requires to extract information from them and enrich it with metadata and tags
In order to turn your images, videos, marketing assets and documents into real assets, you must enrich them with metadata and tags in order to be able to describe and retrieve them easily.
Filerobot supports an advanced system (taxonomy) as well to achieve this purpose.
The asset management modal is the go-to place to manage and collaborate on an asset. You can access it in 3 ways:
Double-click on an asset
via the Manage menu in the contextual (right-click) menu
via the Manage menu in the action bar
4 tabs are available for managing the asset:
This tab shows details about various activities performed on an asset:
Rename
Move
Ownership change
Visibility changes
Metadata changes
Tags change
Labels change
New comment
Sharing & permissions change
Metadata fields are attributes used to describe an asset for further categorization, grouping and retrieval
Filerobot distinguishes two types on metadata fields:
: EXIF/IPTC metadata embedded by the camera or the graphical editor software
: metadata fields created in Filerobot to enrich assets
Filerobot allows the creation of simple or complex metadata structures, aka taxonomies, with each metadata field capable of supporting multiple dimensions, such as translations, currencies, distribution channels or any other variant required by your use case.
Metadata can be viewed and edited during the upload process, in bulk post-upload or individually for each asset in the asset management modal, see .
Assets can then be searched by metadata field values and dynamic created based on metadata field values.
Let's get started!
Security templates are used to generate API access keys (temporary keys with configurable permissions & restrictions)
The Security Templates are accessible from Settings > Development > Security templates
Security Templates can be created with the Add Template button by entering the following informations
Used to identify the security template
Used to defines what users can / can't do with the assets. Permissions are selected from the list:
API Permission | Description |
---|
These settings set limits on the Upload API.
It restricts API calls based on IP address ranges and/or countries.
This setting allows to set validity period of key, for example to match the user's session length in your authenticated application
Directories where the key is allowed to list elements. If you want to allow all subdirectories of /folder, set the value to /folder/*
Existing API keys can be managed individually or in bulk for status (Active <> Deactivate):
General settings for tag management and use
Tags are managed in . In order to see this page, you need to have a Manager, Admin, Developer or Owner .
Control auto-tagging and whether to allow only the predefined tags in the Tags tab
This tab enables the user to create a dictionary of predefined tags, translate them into all supported languages, and specify whether or not they should be suggested (in the asset management details screen).
You can define a new tag in one or more languages by clicking the "+ Add tag" button, which will take you to the end of the list of current tags. In case there is no specific value for some language, the default language value will be used instead of it.
If the toggle button "Suggested" is ON, then the tag will be shown in the list of suggested tags that appears on Asset Edit.
You can Search by Tag name using the Search box and to define how many columns with Displayed languages to be shown while you are editing the Tags data.
If you select one or more tags using the Selection checkbox at the left of the tag's name, then a navigation menu at the top of the page appears and provides the option to Delete or add multiple tags at once to "Suggested".
Metadata, as well a can be translated in multiple languages. You can manage languages from the Metadata variants section under . Edit the Language variant to enable or disable languages.
Please note the special case for the Language variants:
The topmost option will be the default language for metadata and tags
All language options are to be selected from a drop-down list of supported languages (and not free text entries) - the API keys are the ISO code of the language selected, e.g. en for English
the API key cannot be edited
You can also create additional custom metadata variants to declinate a metadata field in different dimension, such as currencies, file format, etc, ...
Leverage the Filerobot Image Editor to edit images directly in the browser
In Filerobot you can crop, resize, apply different filters and add watermarks to your images. You can save the results as or an entirely new asset.
The Edit image button opens the Image Editor.
The Image Editor is a feature-rich inline image editor that supports the most commonly used image editing function of image editing software:
When you are ready with the Editing, click on "Save".
Incorporating metadata enriches your assets with valuable insights, transforming them into more than just files – they become organized, searchable, and informative resources
Asset metadata can be viewed and managed from the asset management modal.
Metadata variants can be toggled using the toggle.
Users with level Contributor or higher, can edit metadata fields during or after file upload.
You can also edit metadata fields of multiple assets in bulk. For that purpose, select the assets you want to edit metadata of and select the Edit multiple assets option from the contextual menu or navigation bar:
You have 2 ways to retrieve assets by metadata fields:
You can search by a specific metadata field in the search bar, pointing to this field with the special symbol @:
If can combine metadata-based search with free text search.
Alternatively, you can use the Metadata filter to select a field and a search value. Entering multiple metadata fields in the metadata filter will perform an "OR" search.
All Hub pages & System Settings Limitation on : Administrators can only manage users with lower levels than Administrator
Only
All Hub pages & System Settings except and settings Limitations on :
If no metadata field is mapped, no notification will be triggered, regardless of the configuration setup.
Parameter | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
File type | Available operations |
---|---|
State | Asset highlighting | Available actions |
---|---|---|
Webhook parameter | Description |
---|---|
Assets trigger | Metadata trigger |
---|---|
File | Video | Image |
---|---|---|
The Details tab displays all descriptive information of the asset such as technical details, product-related information, metadata and embedded metadata. The fields can be edited by clicking on the icon.
Field | Description |
---|
If are enabled, the Product reference and Product position can be set and viewed here.
Custom metadata fields can be edited and viewed here. See for details on how to create the metadata structure.
Embedded IPTC/XMP metadata are displayed here. Requires the Extract embedded metadata post process to be enabled under for this section to display.
Based on the versioning behavior configured on your token (see setting), this tab will show the version history of an asset and allows to restore a previous version.
Furthermore, users can or .
Setting | Description | Default |
---|
Setting | Description | Default |
---|
Setting | Description | Default |
---|
Setting | Description | Default |
---|
User level | Description |
---|
Setting | Description |
---|
Clicking on the button allows to edit languages:
Create a new variant via the button:
To link a variant to a metadata field, navigate to to and either create a new metadata field or edit an existing field suing the button.
Feature | Available options: |
---|
You can edit the metadata information of an asset through the icon in the top right corner of the screen:
If any metadata field is in the metadata structure, no metadata changes can be saved if the field value stays empty.
Notification name
Free text
Notification type
Drop down to select the type of notification: Asset expiry ...
Notification channel
• Email • App • Email and App
Recipients
Specify who will receive the notifications: • Asset owner • Users who downloaded the asset
Notifications schedule
Specify when the notifications should be sent: • On the day of expiration •
Duplicated file
Set a rule for dealing with a duplicate asset: • Accept • Refuse
Same name
Set a rule for dealing with a duplicate asset name: • Refuse • Override • New version
Operation
Resize
Max width
In Pixels
Max height
In pixels
Allow users to optimize images on upload
ON/OFF toggle
Description
To identify the API keys
Secret key
To be kept secret
Created at
The API key creation date
Active
The API key status that can be toggled from active to deactivated using the ... options
-- If used, deactivated API keys will return an error
Copy
Copy the secret key in the notepad for easy integration
images
Resize - set the maximum width and height for the image to be resized to after upload
Edit image - crop; adjust the brightness, contrast and other attributes; add filters; draw on the image; or add watermarks. See Edit images for more information.
videos
Change the resolution - automatically or to fit a specific device type (desktop, mobile, tablet, etc...)
Transcode - generate HLS and/or DASH manifest files for adaptive streaming. See Transcode for more information.
any type
Rename - by clicking once on the filename or selecting Rename from the context menu
Manage details - by choosing the Manage option from the context menu. See Manage assets for more information.
Add metadata - by pressing the Fill metadata button. See Metadata for more information.
... and of course, remove the file as well as add more files for upload (via Add more button)
Mode
Sets if the post processing is SYNC (synchronous, -during the upload- preventing the asset to actually be stored while it's analysed) or ASYNC (asynchronous, meaning that the analysis job will be queued, allowing for the asset to immediately be available in the library)
Run on every upload
When enabled, post process will apply to every upload (allows you to prepare, test parameters, and temporarily put on hold the post-process while not losing the configuration)
Trigger rules
Defines conditions under which the post processing will be triggered. If "no trigger rules" is selected, the post processing will trigger with every upload.
Validation rules
(optional)
Some post-process running in sync mode allow to determine attributes for a file that can be used to decide whether or not to take a predetermined validation action at upload (eg. Notice or Refuse the upload)
Webhook url
Target webhook url to POST event to
Hostname
The domain address of the 3d party to post data to
Path
The domain path to post data to
Basic Authentication
Requires a Username and a password
oAuth2 Authentication
Requires an authentication endpoint (with https://), a username and a password
On upload
On change meta
On move
On change info
On rename
On change tag
On delete
On change label
Name
Width
Width
Size
Height
Height
Path
Length
(in seconds)
MIME type
Bitrate
CDN link
HLS/DASH playlist URL
File UUID
| List files |
| Fetch file |
| Upload file |
| Create file metadata |
| Rename file |
| Move file |
| Delete file |
| Set file visibility |
| Create directory |
| Rename directory |
| Create directory metadata |
| Move directory |
| Delete directory |
| Set dir visibility |
| Change container configuration |
| List container configuration |
| Change product information |
| Perform autotaggin |
| Manage shares |
| Manage airbox |
| Manage approval |
| Manage approval voting |
Limit per min
( | Set the maximum of upload per minute with the key | Unlimited |
Limit per source IP
( | Maximum number of uploads allowed by IP by the key | Unlimited |
Directory scope
( | Directories where the key is allowed to upload. If you want to allow all subdirectories of /folder, set the value to /folder/* | All directories |
| Allowed IP ranges for using the key from | 0.0.0.0 format accepted: 8.8.8.8, 255.240.0.0/12, ... |
| Allowed countries for using the key from. Provide the code ISO of the country | all countries The IP are converted to country thanks to GeoLite2 |
| time in second before the key expires | 1200 s (20 minutes) |
| Directories where the key is allowed to list and search assets. If you want to allow all subdirectories of /folder, set the value to /folder/* | All directories |
Description | To identify the Security template |
Secret key | To be kept secret |
Created at | The API key creation date |
Scope | Used to limit the scope |
Active | The Security template status that can be toggled from active to deactivated using the |
Copy | Copy the secret key in the notepad for easy reuse |
Adjust |
|
Resize | An option to specify the cropping values for width&height manually. You can drag and resize the cropping area with the mouse. |
Finetune |
|
Filters | Select from more than 40 filters to enhance your images. |
Watermark |
|
Draw | Sketching tool |
Successfully uploaded
See Manage assets to continue
Failed to upload
Remove the file
Retry the upload
Duplicate detected (see Storage for possible system policies on duplicate detection)
Remove the file
Show file location (only available if the Duplicate policy is set to Override)
Name | The file name |
Title | Multi-lingual title of the asset |
Description | Multi-lingual description of the asset |
Tags |
Labels |
Orientation | Portrait or landscape |
Main colors |
| This is an ON/OFF toggle button. If set to "ON" this feature will allow Filerobot to generate tags automatically. External providers are used to analyze the asset and push back tag suggestions for the content of your file. |
| This setting limits the number of tags generated by the external provider when auto-tagging an asset. Its purpose is to prevent the generation of a long list of not relevant tags (in addition to the confidence %) |
| It specifies how confident the external algorithm should be that the auto-generated tag is relevant to the image. Values below 50% are considered low while values >80% are considered high. Only tags having confidence equal to or above the configured value will be shown. |
|
|
Faceted navigation available in Filerobot products (Widget, Hub and Portal)
At its core, faceted navigation utilizes a faceted classification system to organize information. This system categorizes items based on multiple, independent attributes called facets. Each added facet acts as new filtering layer.
Concept: Faceted navigation falls under the umbrella of parametric search techniques. Instead of relying solely on keyword matching in a traditional search, it allows users to filter based on pre-defined parameters (facets) associated with the asset. This enables a more nuanced, smarter search experience.
Technology: Faceted navigation relies on efficient data structures and algorithms to handle large datasets and filter combinations. In essence, the system needs to quickly identify items that match all selected facet criteria. Search engines like Solr or Elastic Search are popular choices for implementing faceted navigation due to their ability to handle complex filtering operations.
Benefits: The technical aspects of faceted navigation translate into several benefits:
Drill-down refinement: Users can progressively narrow down results by applying multiple facet filters, leading to a precise subset of assets.
Faceted exploration: Faceted browsing allows users to explore different categories and discover new assets they might not have found through a simple keyword search.
Improved efficiency: By filtering irrelevant options, faceted navigation reduces the number of results a user needs to sift through, saving them time and effort.
Faceted navigation is applied for 4 types of attributes (as of May 8th, 2024)
Date (Uploaded and Created date)
Metadata Single-select
Metadata Multi-select
Metadata Boolean
→ Faceted navigation is only available in the "Assets" view (ie. not in the Folder view)
→ Faceted navigation section is built as a side bar at the left side of the UI, replacing entirely the filter bar (shown below, that will then be hidden) in the Assets view.
This type of navigation is activated at a {token} level, and is a global setting for all users, that can be found at the Preference configuration page.
Within a metadata, the operator between 2 values or more is set to OR
Between 2 metadata or more, the operator is set to AND
In details:
Within a metadata
-> For multi-select, we provide 2 operators: AND
and OR
Let assume we are calling query HAS
(equal to IS
but for multi-select we call it HAS
just for gramatical purpose)
We will have 2 options
Metadata HAS
a AND
b -> expected results are files which have both values a and b, file that contains only a or b won't be returned
Metadata HAS
a OR
b -> expected results are files which has either a or b, file that contains both of the values will be returned also
➡️ This option cover the 1st option -> within a multi-select metadata, we will choose HAS-OR
operator to cover more file results
-> For single-select, it will always be OR
when users click in more than one answers as one file can not contain more than one value.
For 2 metadata or more
For faceted search, it is an AND operator between multiple metadata as the answers will be more specific and this is the main idea for faceted navigation: trimming down the most correct answers
a. Multi-select metadata "colour" with value: “red”, “white”, “black”
When "red" and "white" are searched for -> expected answers are:
Files that contain value red only
Files that contain value white only
Files that contain both value red and white
b. Single-select metadata "size" with value: “35”, “36”, “37”
When “35” and “36” are searched for -> expected answers are:
files that contain 35 value only
files that contain 36 value only
c. Now, combining the two previous examples
When “red”, “white”, “35”, “36” are searched for -> expected answers have to use AND
operator to encompass the 2 metadata constraints, so answers will be assets that contain:
red and 35,
red and 36,
white and 35,
white and 36,
red and white and 35,
red and white and 36
→ Refining searches further is leading to more accurate and relevant results.
OBJECTS_LIST
List files
OBJECTS_FETCH
Fetch file
FILE_UPLOAD
Upload file
FILE_META_CREATE
Create file metadata
FILE_RENAME
Rename file
FILE_MOVE
Move file
FILE_DELETE
Delete file
FILE_SET_VISIBILITY
Set file visibility
DIR_CREATE
Create directory
DIR_RENAME
Rename directory
DIR_META_CHANGE
Create directory metadata
DIR_MOVE
Move directory
DIR_DELETE
Delete directory
DIR_SET_VISIBILITY
Set dir visibility
CONFIG_CHANGE
Change container configuration
CONFIG_LIST
List container configuration
FILE_PRODUCT_CHANGE
Change product information
FILE_PROCESS_AUTOTAGGING
Perform autotaggin
OBJECTS_SHARE_MANAGE
Manage shares
OBJECTS_AIRBOX_MANAGE
Manage airbox
OBJECTS_APPROVAL_MANAGE
Manage approval
OBJECTS_APPROVAL_VOTE
Manage approval voting
Tags are pre-set values which can be applied to assets for filtering and classification purposes. Tags can also be generated automatically based on image content using integrated AI-based image recognition algorithms.
You can add tags to assets using the Bulk Edit or Single file edit functionality.
In order to assign a specific tag to multiple assets, you need to select the files and then to choose option "Edit multiple assets".
Then choose "Tags" and you can select the tags that you would like to apply to your assets (tags must already be present in the list in order to be assigned, you can't create a new tag while bulk editing).
Clicking on "Regional settings" you can choose the language on which to apply your tags.
You can assign tags to a single file by selecting that file, then clicking on "Manage" and choosing the icon representing "Edit metadata".
At that point, you will get the option to add new tags, choosing them from the "Suggested" list or generating them using AI service (if this feature is enabled for your project). If you start typing a tag that is currently not existing in the Tags list, it will be added to the list and attached to the asset at the same time.
For that purpose, you need to use the Bulk Edit functionality. Please select the files that contain the tag which you want to detach and choose the "Editing multiple assets" option. Then in the Tags section choose "Delete" and specify the tag that you want to remove.
Please select the asset which tags you want to edit, then go to "Manage" and open the "Edit metadata" mode. Now you have the option to remove tags by clicking on the "x" symbol at the top-right corner of every tag or to choose the "Clear all" option so to delete the entire tags list.
In order to search by a specific tag in the Search box, you need to type #name-of-your-tag
or to use the dedicated Tags filter.
A collection is a group of related assets defined by a set of properties such as meta, tag, file type etc.
Example: A collection of Cars may contain all assets tagged with #car
or having "Car" as a value in the metadata field "Vehicle type".
The main difference between grouping assets via Folders, Labels, My favourites vs Collections is that the membership of assets to a group is dynamic when using collections. This means that assets are automatically added or removed from a collection based on their technical properties and metadata values.
This Collections sub-page can be accessed from the main menu on the Library page:
In the collections list, the collections submenu has the following options:
Name: sort by name ascending or descending
“Sort” icon: if the collections are currently sorted by name ascending then this will sort them descending and vice-versa
“Planet” icon: allows to select the metadata/tags language
Refresh: refreshes the collections list
"Info" icon: if an asset is selected, provides additional details for it
You can do this by clicking on the button + Add collection. A pop-up Configuration panel will open.
Name - please specify a meaningful collection name
Access - by default it is Company. Only users with access to Filerobot Hub can see these assets.
Filter type: Query - the user creating the collection needs to write a search query inside the text area to define filters.
Query - here should be placed the filtering query for the collection
Groups - the groups are an alternative of the Filtering Query. They contain a list of pre-defined collection criteria and can be used in combination with the Query or on its own.
In order to open the Configuration window, allowing you to manage your collections, you need to click on the "Settings" icon in the left panel of the page:
That will open the "Manage collections" window where you have options to Search, Add new collections, Edit the current configuration or Delete existing collections.
Labels are used for categorizing and describing items, allowing for flexible grouping and easy Search. One asset can have multiple labels.
Labels allow users to organise their assets in a more structured and permanent way than Tags. They are static - unlike the dynamic Collections whose assets change through applicable filters - and are similar in principle to the labels on physical products (drinks, foods, clothes).
Users can still modify a given label and/or change which assets fall under it.
The system also allows users to view and search both the labels and their applicable assets.
The Labels page can be accessed from the main menu on the Library page:
You can create named, colour-coded labels by clicking on + Add label
button. This allows you to list and manipulate all assets assigned to a specific label in a single view.
Title - please choose a meaningful name for your new label
Colour selector - you can choose a color for your label by clicking on the pre-defined colors or specifying its RGB code in the field bellow
Pinned - if this checkbox is marked, then the new label will appear on the top of the labels list. On Sort the system will sort first the Pinned labels and then will show the other ones.
In order to open the Configuration window, allowing you to manage your labels, you need to click on the "Settings" icon in the left panel of the page:
That will open the "Manage labels" window where you have options to Search, Add new labels, Edit the current configuration or Delete existing labels.
If you want to delete a label, it is a good practice to ensure that the number of the current assets assigned to it, is "0".
Invoking the context menu on an individual or multiple selected assets and choosing the Labels
sub-menu lets the user search and apply the available labels:
If, during the Search, no exact match is found, the user has the option to create a new label and apply it to the asset immediately:
This function is available on the Labels page when selecting a file and opening its context menu:
The user can select multiple files too and use the ...
icon in the Navigation bar in order to access the same option.
In both cases, in order to be able to detach a label, the user should have a Developer, Manager, Admin or Owner User Role.
You can search by specific search criteria inside the pool of all assets assigned to a specific label, using the main Search box:
In case you are interested in finding all assets assigned to a specific label, you can search for this label's name in the Search box at the left panel and then just click on the result:
Filerobot provides multiple options for organizing your assets in order to facilitate the Search, collaboration and sharing of ideas.
Structure | Description |
---|---|
Embedded metadata may contain for example the GPS coordinates of where the picture was taken, the author, the camera, the lens, ... Filerobot can extract these metadata, including ones from custom namespaces (for example model name, product category) and map it to custom metadata.
To enable the extraction of embedded metadata, navigate to Settings > Development > Automations and enable the Extract embedded metadata post process.
Once enabled, Filerobot will extract embedded metadata from asset upon upload and display them in the Details tab of the asset management modal:
To leverage search and collections grouping based on embedded metadata, contact our support team to enable the mapping between embedded metadata and custom metadata.
The users have the option to define metadata structures, create new fields and group them into different categories. This kind of metadata is defined per Filerobot project (token) and applies to all assets in it. You can have different metadata taxonomies if you have multiple Filerobot tokens.
See Managing metadata.
Process settings cover many of the key functions in your Filerobot account
Add one or multiple custom domains to deliver DAM assets over your subdomains, for example medias.acme.com. Once the custom domain added, you will need to create 2 DNS CNAME entries to validate the TLS certificate and point your subdomain to Filerobot.
Example:
DNS1: _076f48ef8df3a3ca368b89c6f0bb0bcf.medias.acme.com. CNAME _29163927834ee4c4e03c365fd7282c74.nhqijqisfx.acm-validations.cdnprovider
DNS2: medias.acme.com CNAME token.cdnprovider.com
If you want to change your domain, please contact support
Aliases can be used to shorten your Filerobot URLs and hide parts of the asset folder path. We recommend prefixing and suffixing the aliases with underscore '_' to avoid loops.
User create custom transformations using presets to shorten the Filerobot URLs.
Rules allow to apply default transformations on assets based on the asset’s filename.
Allow Filerobot to deliver externally hosted assets
In case customers want to use their Filerobot token to deliver externally hosted assets (= Cloudimage only functionality) and want to limit the list of domains hosting assets that origin assets can be downloaded from, a domain white list can be created.
WebP is a format optimized for web and mobile delivery. Filerobot can compress your images automatically into WebP to reduce bandwidth and improve loading times.
This section governs the video compression settings of the project. Video compression involves the transcoding of an original high resolution video file (HD, UHD, 4K, …) into smaller resolution for better web delivery (720p, 480p, …).
This section governs the video conversion from one format to another.
This section governs the video transcoding for adaptive streaming settings.
These settings govern the delivery of static content (JS/CSS/PDF, …).
In Filerobot Hub you can organize your assets by folders. This view is available in the left panel of the Library under the name "Folders":
It consists of a navigation panel where the folders and their sub-folders are hierarchically ordered and an expanded view where you can preview the content of the current folder. It is available in a Grid view or a List. The view is controlled by the following icon:
If you select a single folder and then click on the "Info" icon at the top right part of the page, you will open a panel showing the folder's details:
In order to create a new folder you can use the + New Folder
button at the top right part of the page. The new folder will be created as a sub-folder of your current folder's location.
Please note that "/" is treated as a special symbol in the folder name. If you specify "Media/Images", the system will create a folder "Media" and a sub-folder "Images" inside it.
If you select a folder and open its context menu, you have the option to download its content. The same action is available from the navigation bar and the download icon at the top right corner of the selected folder. The content is exported as a ZIP archive.
This option is useful in cases when you need to get details about the folder's content.
Please select the folder, open the context menu and choose "More actions -> Export list of files (CSV)". At this step you can choose to export the file details of the entire project, only the files placed directly in the selected folder or the folder+its nested sub-folders.
The information that is exported in the CSV contains:
filename
CDN link
mime-type
size
file uuid
creation date
update date
visibility settings
If you know the name of the folder in which you are interested, you can jump directly into it using the small Search folders box:
If you know that some file is located in a specific folder, you can use the main Search box to specify this folder and then apply additional search criteria in order to find the files you are interested in:
"My Favorites" are typically used to quickly access frequently visited assets. They provide a way to create a personalized flat list of preferred items for easy access.
Users can mark assets as favorites and view / search these assets under the My favorites submenu for quick access. Each asset can be marked as favorite or not and each user can access their list of favorite assets via Menu > My favorites:
The user can add an asset to My favorites list by simply clicking on the heart icon at the bottom right corner of the asset:
An asset whose icon is colored in purple is already added to this list, while an asset whose icon is in grey is not part of My favorites.
Users can add multiple assets in bulk to My favorites list by selecting them and then opening ...
-> Add to -> My favorites in the Navigation bar:
In the same ways, an asset or a group of assets that are already added to My favorites list can be removed from there.
Transformations are dynamically generated variations of an origin asset
Unlike versions or edited images, transformations do not create separate files in the DAM.
Transformations are generated via URL query parameters and can be created graphically via the Filerobot Image Editor for single assets or programmatically in bulk.
There are 2 ways to use transformations once created:
Download them to your local computer for further re-use. Various formats are available when downloading a transformation.
Deliver over optimized (JPEG, WebP or AVIF) CDN URLs
When you are using Filerobot DAM, you will notice that we introduce the concept of File Version vs. File Transformation.
In order to create a new image transformation, you can open the transformation panel within the Asset Management modal:
Here the user has the option to create a new transformation by clicking on + Add transformation box. The Image Editor pops up and allows the user to create and save a transformation graphically:
Once the transformation is saved, you can hover over it to either download it directly or copy an optimized CDN link to your clipboard for further distribution:
For example, the optimized CDN link to the feed portrait transformation for Instagram looks like:
The query parameters suffixed to the image CDN URL trigger Filerobot to generate the transformation on-the-fly and cache it in the CDN.
Unlike single transformations which are created using the Image Editor for each asset, custom presets are the way to go when it comes to generating transformations automatically in bulk.
Navigate to the Settings / Project / Process / Delivery URLs page and scroll to the Dynamic asset transformation presets section to create a preset:
To create the new Preset, click the "+ Add preset" button and pick a file to work on. Then, an Image Editor will pop up, letting you crop the test image as you like, add a watermark, or apply a certain effect.
When you are ready, save the changes. Filerobot will generate a Preset, containing the chosen operations and filters. You can always review the exact configuration and rewrite it using the "..." menu -> Edit or Edit in Image Editor.
For each Preset, you can set the "Autogenerate" option and the transformation will apply automatically whenever you upload new images.
Additionally, you can select only specific Presets (image transformations) to be generated during image upload.
The custom preset created above can be used with the query parameter p (for "preset") to generate the transformation:
Advanced search and filtering
The search bar allows user to use simple search with keywords
Advanced search is activated by typing the @
sign and selecting one of the dedicated search operator (filename,...). This allows user to search in specific fields - file, metadata, asset properties, etc.
User can also use the Context dropdown to narrow down the search scope to a specific folder or to Favourites.
User roles, permissions and teams
Filerobot's role-based permission model allows you to create users with different privileges, setting who can access and add assets as well as contribute by editing and annotating assets, or access billing information and analytics.
The Asset Hub allows you to grant mulitple users different privileges to manage, collaborate on and distribute digital content.
Filerobot offers the following user roles:
Filerobot allows you to group users in teams for easier role and permission management.
Comments with annotations
Images annotations allow you to communicate with fellow contributors and discuss features of the assets. Comments and annotations are timestamped and are available to all users with editing privileges.
The comment section is accessible from the context menu and the preview modal of each asset.
Users, permissions and comments
Filerobot's multi-users and multi-tennant model allows users to upload, manage, collaborate on and distribute digital content in different projects via the Asset Hub.
The commenting system allows you to place annotations on images for easier communication.
Find Similar assets is a hub feature that allows the user to select an asset and generate with AI a list of existing assets sorted by similarity to the original asset
It is an alternative way to find assets in the hub without using the metadata & standard search
Find similar assets are available on specific tokens (PT_ADVANCED) and require the post process "Vector / Embed" to be enabled: only assets that have been vectorized using this post process are visible to the feature
Assets supported are images (PNG, JPG, WEBP)
In any of the hub page, simply select an asset (image: png, jpg, webp) et choose the find similar option in the contextual menu
After computing, you will be presented with a list of assets sorted by similarity with your original asset (indicated with a purple tag): most similar assets are displayed first
Nota
The results generated largely depends on the assets available in the hub (ie if the asset selected is unique, the similar assets suggested will be less relevant
Publishing and collaboration with third parties
Filerobot allows delivery of your assets over and using all Media optimizer capabilities (for use in webpages and web applications). You can also collaborate with non-registered users via secure URLs:
AI powered search is a hub feature that allows the user to search assets by simply typing prompt in the search (like "photo of villa with swimming pool) It is an alternative way to find assets in the hub without using the metadata & standard search
AI powered search is available on specific tokens (PT_ADVANCED) and require the post process "Vector / Embed" to be enabled: only assets that have been vectorized using this post process are visible to the feature
Assets supported are images (PNG, JPG, WEBP)
In the asset page, simply switch the AI toggle on to activate the AI Search and enter the prompt:
After validation, you will be presented with a list of assets matching the prompt and sorted by relevance: most relevant assets are displayed first
Nota
The results generated largely depends on the assets available in the hub and the prompt used
Third-party asset sharing
Sharebox allows you to share assets with third parties without access to Filerobot Asset Hub.
To create a Sharebox, you need to select the assets you would like to share and open the Share Assets modal in the top bar or the context menu—Share / Via Sharebox.
Each Sharebox can optionally be password-protected, have an activation and expiration date, and provide options to disable or enable asset downloads. Additionally, you can invite users by email to access the Sharebox.
You can view, modify, or delete Sharebox instances from the left menu in your library under "Sharebox." For example, you can change the password, activation date, or expiration date.
The number of elements shown corresponds to the total of folders and files shared. (For example, 1 folder containing 10 images will be counted as 1, while 10 individual assets shared will be counted as 10.)
Collaboration with third parties
Filerobot offers a mechanism to collaborate with third parties by allowing them to upload and download assets to your container via dedicated URLs.
A single-user interface to easily share your latest assets with stakeholders.
Managing, finding and sharing your visual assets has never been easier, with the right environment for the right task, thanks to Scaleflex Brand Portals.
The following sections of the documentation will help you easily , then, and finally your Portal:
Third-party asset upload and download
Airbox allows non-registered users to upload files using public links. Airbox instances can optionally have an activation and expiration date and password protection. You can also invite users by email, set limitations, and configure notifications, and receive notifications upon asset upload.
To create an Airbox instance, select Airbox from the left menu of your Filerobot library. Set the start date and expiration date (optional), enable password protection if required, click Invite Users to send invitations via email, define any limitations for uploads (e.g., max file size, max size of all uploaded assets, and max file count), and configure notifications for users, team members, and the Airbox owner on asset uploads.
You can view, modify, or delete Airbox instances from the left menu in your library under "Airbox." For example, you can change the password, activation date, or expiration date, set limitations, and Recipients.
If you attempt to use the same target folder as another active process, an alert box will appear, indicating that the folder is already in use. Select a unique folder for each process to prevent conflicts and avoid this.
Deliver Filerobot assets via CDN
All public assets in your container can be shared or published in a webpage or a web application by using the CDN link. This link allows you to take advantage of all avaliable media optimizers via URL parameters. More details are available in the media optimizer article.
CDN links can deliver only public assets. For more details, please see the section.
This link is also available in the for all public assets.
Filerobot Media library download
You can download assets one by one or from a selection by using the context menu or the selection top bar.
Filerobot allows you to apply transformation on the downloaded assets to crop images, reduce dimensions, convert to another format or compress the files into a single archive.
If need to create profile images or covers for social media, you can use the Social media presets with pre-defined aspect ratio for cropping. The available options include profile pictures, covers, logos, etc. to use in LinkedIn, Facebook and Twitter.
Get alerted when events of importance need your attention
Notifications allow to specify when to be alerted about important events such as asset expiry, being tagged in comments, and many other significant events.
Notifications are set per project and are configured in (see ).
Click the bell icon in the header to view any notification.
If there is at least one unread notification, a red dot is added to the bell icon:
The notifications overlay provides the following capabilities:
Asset visibility settings
Each asset in your Filerobot container can be either private or public.
Public assets are accessible by everybody via their while private ones are avaliable only to users and teams with the appropriate permissions.
This modal allows you to change the visibility settings for each asset or a selection of assets. By default, the visibiliy is inherited from the parent folder or the container. The container visibility can be defined in the Storage settings, section.
Please note that if you edit the permissions of a selection of assets via the Publish modal, you will override the visibility of all selected assets without being able to see their previous settings.
If the visibility is set to public, you can copy the CDN link from this modal.
Multi-lingual tags associated to the asset. Tags can be added manually (free input or from tag dictionnary) or automatically via AI. See .
Labels are advanced tags with a dedicated page to view labeled assets. See .
Image's main colors. Requires the post process to be activated.
A toggle button which, if set to "Yes", disables the Auto-tagging and allows Filerobot to use only the list of already defined tags in the
List of the languages that the tags support. To add/edit/delete languages, please refer to the section
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
Setting | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Parameter | Description |
---|---|
Role | Description |
---|---|
: Your visuals are ready to see the world? Create a Brand Portal and share them with selected stakeholders through a fully customizable gallery.
: Share approved brand assets simultaneously with partners, retailers, press, sponsors or marketplaces.
: Keep everyone informed of brand guidelines and appropriate usage through notifications from the Brand Portal.
Setting | Values | Description |
---|
To enhance user flexibility, Filerobot supports a convenient download feature through the use of the query string parameter &download=1.
When appended to , this parameter triggers the download of the original asset associated with the link.
Feature | Descriptioon |
---|
For example, if a user clicks on an asset expiry notification (whether on the day or for a day in the future), the user will be taken to the page, with the relevant metadata filter applied, displaying the expiring assets (see ).
Folders
Most people are familiar with the concept of folders, making it easier for users to grasp and navigate through this structure
Collections
The collections organize files using specific metadata criteria, allowing for automated update of Collections content
Labels
The labels are categories that might contain multiple files, gathered manually together
My favorites
Adds files temporarily to "My favourites" mostly with the purpose of easily finding and accessing them later on
Domain name
Domain name without https://
Alias
_alias_
Redirect to
url to redirect to
Note
Preset
Preset name (ex: full-view-sm...)
Redirect to
Operations & filters (ex:h=900&w=1200&func=bound&org_if_sml=1)
Description
Note (ex:Gallery Full View on Mobiles)
Rule match
Rule (ex: .png)
Parameters
Operations & filters
Description
Note
Domain name
Domain name without https://
Compress all PNGs to WebP automatically
On/Off
Compress animated GIFs to WebP automatically
On/Off
Compress all other image formats to WebP automatically
On/Off
Enable AVIF compression
On/Off
Compress by default
On/Off
Default compression factor
Integer
Progressive JPEG
On/Off -- Progressive JPEG enables the loading of a low quality preview while the full image is loaded. Enabling this feature will slightly increase the file sizes of your JPEGs.
Enable PNG lossy compression
On/Off
Default PNG quality
Integer
Rasterize SVG
On/Off -- When active, all SVG files are converted to a raster image.
Enable SVG lossy compression
On/Off -- Reduce the number of curve nodes and remove invisible elements to decrease filesize.
Keep origin image ICC profile
On/Off -- Always remove ICC profiles and convert images to sRGB. Might decrease processing performance.
Convert ICC profile to sRGB if too large
On/Off -- Remove ICC profiles and convert to sRGB only for large images.
Convert ICC profile if larger than
Integer
Video resolutions
Configures the target video resolutions
Target bitrate
defines the target bitrate (only accept integer)
Target folder
Defines where compressed video will be stored: • Internal hidden folder • Same folder as original video
Target format
Configures video conversion target: • WebM • MP4
Video resolution
In addition to convert the video file into WebM or MP4, the video API can also compress (see above) the video into a target resolution
Target folder
Where the converted video will be stored: • Internal hidden folder •Same folder as original video
Protocol
• HLS • DASH
Enable static content acceleration
ON/OFF -- Accelerate any static files over CDN. Enabling this feature requires images to have image file extensions (.jpg, .png, .webp, .gif, ...)
Max-age
value in seconds
S-maxage
value in seconds
Automatic origin image refresh
On/Off
Image origin refresh period
value in seconds
Viewer
View-only access to assets.
Contributor
Allows access to the assets in the project(s) they are invited to - no access to configuration management and company details.
Developer
Grants access to the assets, stats & logs, as well as process and acceleration settings. Can use Security Templates (cannot create or edit one) in the respective project(s) they are invited to.
Manager
Has all Developer permissions plus:
can invite and manage Contributors and Developers within the project(s);
can set and edit Security Keys and Security Templates;
can manage all project settings.
The Manager role grants no access to the company bank account settings or invoicing information.
Accountant
Grants access to the billing and invoicing systems only (no access to the container's assets).
Administrator
Full access - the only restriction is that the administrator cannot manage other administrators.
Owner
Full access - only one Owner per company is allowed.
Extensive role-based permission model and user teams ensures access only to relevant resources.
Allows you to collaborate by adding timestamped comments with annotations on each asset.
Any public asset can be shared or published via a CDN link
Controls the visibility of each asset/folder or the whole Filerobot container
Allows asset download and upload by external users
|
| Output format |
|
| Compression quality |
Resize:
| integer | Limit image dimensions (in pixels) |
Crop:
| integer | Image crop dimensions (in pixels), available in advanced transformation only |
Number in brackets in the title, e.g. (10) | Tells the number of unread notifications |
Elipsis menu (...) | Additional actions, such as Mark all as read |
Blue background & blue dot in upper right corner of notification (dot can be toggled) | Unread notification |
White background & white (hidden) dot in the upper right corner of notification (dot can be toggled) | Read notification |
Notification date | Date when the notification was triggered |
Red clock notification icon | Notification for asset(s) expiring today |
Yellow clock notification icon | Notification for asset(s) expiring in a number of days (as configured) |
Action link | Takes the user to the relevant notification object (asset(s), comment, etc) and marks the notification read |
Third-party product integration
In the realm of ecosystem integration, seamless connectivity plays a crucial role in facilitating communication and interaction between different third-party components.
This introductory guide aims to clarify the distinctions we do among the two main types of software connections: plugins and connectors (aka applications).
Plugins are software components designed to extend the functionality of a larger application. They allow developers to add specific features or behaviors to an existing software system without modifying its core codebase. Plugins are usually loaded dynamically at runtime, making it easier to add or remove them without affecting the main application's stability.
Plugins provide a modular approach to integration, enabling third-party developers to integrate seamlessly Filerobot into the host application/software, simply using our Filerobot Media Asset Widget to replace or complement the media gallery used by the third party software/tool.
Applications, also known as standalone connectors or adapters, are complete and self-contained entities designed to perform specific tasks or provide a range of functionalities to users. Unlike plugins and libraries, applications are intended to be independent and tightly integrated.
Our applications have their own user interfaces (UI) and may interact with other applications or services independently. They will always be performing a range of additional functions like programatic synchronisation and similar advanced features.
In summary, plugins extend the functionality of existing applications with a more passive role, while applications/connectors facilitate interoperability and seamless synchronisation between different systems by being placed in between them and actively intervening.
In any case, a manual integration will always be possible by the use of our Filerobot Media Asset Widget, whose code/package is linked in this documentation.
Assets can be filtered by their creation or last modification date using pre-defined or custom time frames
With the format filter, user can choose from a list of asset types or file formats depending on the content of the Filerobot container
Filtering by filesize by entering a size range
This option allows user to filter by selecting one or more tags in the container
The metadata filter allows user to select multiple metadata fields as well as multiple values for each field and apply them as filters
The image group of filters lets user filter by image dimensions/resolution, contents, color or aspect ratio
A new filter called "Products" has been added to the search bar, allowing users to filter results based on the product_ref field. This feature lets users search for multiple product values at once and easily combine product references with any other metadata filter or grouping.Users must go to the Preferences section under the Project tab and toggle the Products Filter setting to enable this filter. Once enabled, the "Products" filter will be available for use in the search bar.
To create a new team, you can use the Add team button.
You can also add an avatar to the team, if you wish.
You can add members to each team from the existing users or invite them by email.
The comment systems allows threading and sorting. To keep track of progress, you can mark comments as resolved.
Simple transform: - limit image dimensions; - set compression format and quality. |
Advanced transformation: - image cropping - limit image dimensions; - set compression format and quality. |
You can access the Publish modal from the context menu - Share / Publish. |
The Filerobot Adobe CC embeds the Filerobot Media Asset Widget (FMAW) plugin inside the following supported Adobe applications:
Adobe Photoshop
Adobe Illustrator
Adobe InDesign
No more copy-pasting media assets from your local drive to Filerobot, everything happens from within your Creative Cloud application.
Step 1. Download the extension files from the link and unzip them.
(use the following in your browser if you can't download from the above URL link)
Step 2. Copy the unzipped folder content into the folder for your Creative Cloud version:
If you have Photoshop CC 2014, CC 2015, CC 2015.5, CC 2017 or above:
Mac OS: /Library/Application Support/Adobe/CEP/extensions/
Windows x64: C:/Program Files (x86)/Common Files/Adobe/CEP/extensions/
If you have Photoshop CC:
Mac OS: /Library/Application Support/Adobe/CEPServiceManager4/extensions/
Windows x64: C:/Program Files (x86)/Common Files/Adobe/CEPServiceManager4/extensions/
You have to create the folder if it does not already exist.
Step 3. Restart Photoshop and you will find the Filerobot widget/extension at Window > Extensions > extension_name.
First, you need to log in to your Filerobot account from the Widget.
Then, you can select the Company and Project you would like to access (for multi-project Filerobot accounts).
You can browse your container and its folder structure directly from the widget and use the search and sort functions. You can also create folders.
You can upload images from Photoshop directly to your Filerobot container. Downloaded images from Filerobot can be inserted as a new file or as a new layer in existing Photoshop project.
...
...
Filerobot Contentstack App
The features of the Filerobot Contentstack App include:
Asset Manager widget in Contentstack Content Management;
Multiple file type support;
Metadata sync: asset metadata from Filerobot will show on your Rest/GraphQL response.
There are 3 simple steps for enabling the App on your Contentstack instance
(prerequisite) Have a Contentstack Account;
Obtain a Filerobot token (request it here);
Install the Filerobot App from the Marketplace;
Add your security configuration parameters to access your Filerobot library.
Register for a demo if you don't already have a Filerobot account.
Sign up to Contentstack.
Updating
Security Template Identifier: Security template ID, found in the Developers top menu;
Container: Your Filerobot token from the Asset Hub interface;
Custom Field
JSON Rich Text Editor
Step 2. Select Scaleflex Filerobot
Step 3. Save and Close
Step 4. On Your Entry open Filerobot and choose image
Custom Field
JSON Rich Text Editor
Filerobot Prestashop plugin
Supports the default versions of Product Media and TinyMCE (and not other TinyMCE Plugins);
Supports Prestashop from version 1.7.8.7 onwards.
Register for a demo if you don't already have a Filerobot account.
- Download the Filerobot module
Step 1: Download the latest version Download Latest release of Module
Step 2: Unzip the file and change the folder name to "filerobot"
Step 3: Zip the file with the name "filerobot.zip"
Step 4: In Admin go to Modules/Module Manager -> Upload the Zipped file
- From the Marketplace
Step 1: In Admin go to Modules/Module Catalog and search for "Filerobot by Scaleflex"
Step 2: Click "Install"
Step 3: Go to Modules/Module Manager -> Other Section -> Click on Configure on "Filerobot by Scaleflex"
Step 4: Update the configuration (credentials) and activate the Module, then your site is ready to go.
Activation: Enable/Disable the module
Token: Your Filerobot Token
Security template identifier: Your Filerobot security template (in the top menu Developers)
Filerobot upload directory: The directory where you want to store/manage assets
Product media
Go to Catalog/Product -> Click +
button in Product Images
Choose images and click Insert
Product WYSIWYG
Click the image
icon on WYSIWYG
Then it is the same as for a Product Media click Insert
after choosing your image(s)
Filerobot Magento Plugin
The Filerobot Plugin is an extension which adds Asset Management to the Magento Admin (Product Images, Tinymce 4 WYSWYG) and shows it on the Front-end (Product listing page, Product detail page, Minicart, Cart Page, and Checkout Page).
There are 3 simple steps for enabling the plugin on your Magento 2 website:
Obtain a Filerobot token (request it here);
Install the Filerobot module for Magento 2;
Add your security configuration parameters to access your Filerobot library.
Please note that the plugin will make some changes in the Admin section.
Currently, the plugin only supports the Text Component in Page Builder; other components will be supported in future versions.
TinyMCE Image (Insert/Edit) default function will be disabled. You can change the image size by scaling (drag and drop function) or delete it and add a new one with the size you like;
The plugin will disable the default upload function in Product Edit Page. Instead, every asset will be managed by Filerobot (single source of truth).
The plugin works well with the Magento Luma default theme. If you use a different theme, please check the manual integration below to get the product images.
You can register for a demo if you don't already have a Filerobot account.
Filerobot supports Open Source and Commerce Edition from version 2 onwards.
If you have a question or need assistance, feel free to contact our support.
To be able to install the module by Composer, you need to get a copy of the module on the Magento Marketplace, or directly from Github. Then, unzip the source code to app/code folder.
Enable and install the following modules in Magento:
php bin/magento module:enable Scaleflex_Filerobot php bin/magento setup:upgrade php bin/magento setup:static-content:deploy
Once the steps listed above are completed, you need to enter your Filerobot token and security template into the Filerobot module configuration the Magento admin interface: Stores > Configuration > Filerobot By Scaleflex > Filerobot integration.
If your token and security template id is verified, please activate the module by selecting Yes in the Filerobot Enable dropdown then save again.
After all is done, you will be asked to flush your Magento cache.
You will not be able to activate the plugin until the token and security template id are correct.
Filerobot Token: Your Filerobot token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Developers top menu;
Filerobot upload directory: This is the top storage folder for your assets. The default value is /magento
.
Please create the folder in Filerobot first to prevent an error. If you want to change it, you need to check if the folder exists in your Filerobot container.
Please click on Icon Filerobot on TinyMCE:
Then choose which images you want to insert -> transform:
You will be able to select and insert one or more images:
If you want to change the image size, please choose one image at time and click Insert. After that, you will be able to set the desired image dimensions.
If you want to change the dimensions of an already inserted image, you can use Tinymce Image size drag and drop.
Go to Product Edit Page in Images and Video Tab, then click Image Manager. Then you can use the file manager like TinyMCE above.
Scaleflex DAM(Filerobot) Contentful App
The features of the Scaleflex DAM(Filerobot) App include:
Asset Manager widget in Contentful Content Management;
Multiple file types support(images, video, documents)
Metadata configuration:
Asset metadata from Scaleflex DAM will show on your Rest/GraphQL response
You can choose which attributes will be saved in contentful content field
Configuration for limited file types and maximum file count
There are 3 simple steps for enabling the App on your Contentful instance
(prerequisite) Have a Contentful Account;
Obtain a Scaleflex DAM token (request it here);
Install the Scaleflex DAM App from the Marketplace;
Add your security configuration parameters to access your Scaleflex DAM library.
Register for a demo if you don't already have a Filerobot account.
Sign up to Contentful.
Contentful is 100% Cloud Native, so you have to sign up for a hosted CMS at https://be.contentful.com and you will get a link to your space:
There are 2 ways:
Find it here https://www.contentful.com/marketplace/ and install it or click install now on https://www.contentful.com/marketplace/app/scaleflex-filerobot/.
Click Install to Contentful bellow
Token*: Your Scaleflex DAM token from the Asset Hub interface;
Security Template*: Security template ID, found in the Developers top menu;
Asset directory: This is the top storage folder for your assets, default is root dir(/)
You can quickly validate your token and security template by click "Validate Scaleflex DAM Setting"
Limit: The max number of files that can be added to a single field
Attributes: A string containing information (JSON attributes) that you want to store in a Contentful field, separated by commas. For example: meta, info.
Limit Type(s): String type, acceptable values: any or all of the following: 'image', 'video', 'audio', 'application', 'application/zip', 'application/x-zip-compressed', 'application/vnd.rar', 'application/x-rar-compressed', separated by commas.
Please hard refresh your browser each time you change the settings for them to take effect.
In any content model, create a new JSON Object Field
In Appearance section, choose Scaleflex DAM
Select one or more assets you want to add to the field.
Click "Insert" on the top right corner of the opened Dialog
You can have 2 options:
Insert as original
Insert as transformed(change the image extension type, image size)
After inserted, assets will appear like bellow:
Reorder assets position by drag and drop
You can delete unwanted asset(one by one - click on 3 dot then select delete) or click Clear all to remove all selected assets
Update manual update metadata if any change from the hub, please use "Refresh Assets" button
Allows third parties to upload assets to your container. Supports password protection and activaton scheduling. |
For sharing specific assets with third parties. Supports password protection and activaton scheduling. |
Similar to a headless CMS or a PIM, a Headless DAM decouples the media asset management back office from the web or mobile interfaces used to publish assets
A Headless DAM helps decouple the creative process from the workflows required to publish media asset on the web and mobile. For example, creative teams or app users will feed media assets into Filerobot via the The Filerobot Asset Hub or the Media Asset Widget, while developers will use Filerobot's Headless DAM capabilities to publish the media assets on the target web or mobile applications.
A headless DAM is a DAM that allows the creation of custom frontends or galleries to provide an integrated upload experience or display media asset galleries in flexible ways.
A Headless DAM integrates well in a composable architecture, for example for an E-Commerce project with an ERP, a PIM and a CMS.
A Headless DAM enables publishers on various channels to upload, process, and publish digital assets with the least amount of work and maximum effectiveness. Headless DAM is one of the finest options for brands and companies who wish to distribute massive volumes of digital assets across numerous platforms.
With customizable user interfaces, cross-platform data exchange, and streamlined workflows, Headless DAM offers users a quick and fast way to manage their digital assets.
To add a new language option to your portal, navigate to the very top right corner of your screen. There, you will see a button with the name of your primary language (in our case, “english”). Click on it, and a dropdown menu will open. Here, you will see the languages you currently use. You also have a search bar to browse through them easily and the button “+add new language”. Click on it.
When you do, a modal will open, where you can select your new language. Once you have, click on “add.”
This will add a new language option to your portal. What does this mean? Each language option is an identical copy of your portal. Translations aren’t done automatically within the portal, but you must manually input them. This manual change will only be saved in the language version of your chosen portal. This means you can manually translate English text to German in the “German” version, and these changes will be exclusively recorded and saved here. You can add as many languages as you’d like in this way!
You will often see a snake-like icon over certain containers and sections. This icon allows you to redirect to the hub. For example, let’s say we want to redirect one of our CTAs to the hub. Hover over the CTA button; three icons will appear on top. The pencil allows you to edit the button, the chain to link to pages or sections, and the snake-like coil to link back to the hub. Click on it.
Once you do, a modal will open. Through it, you can set up a redirection to one of your hub’s gallery pages. Firstly, you can select one of your galleries through a dropdown menu. Next, you can determine whether the redirection should be to “anywhere” within that gallery, a collection, product, folder, or specific label. If you were to choose any one of the options apart from “everywhere”, an additional question will appear: “Which collection/product/folder/label?”. Select accordingly.
Finally, select if and how you wish your metadata filters to be included. You can choose for them to not be included in the display, include them as page filters, or in a “custom” manner of your own choosing. Having established these parameters, you may click “save”. The modal will close, and your hub redirection is ready!
You can preview your portal on multiple devices. To do so, navigate to the top right corner of your display, next to the language options. You will see a button with the word “desktop” in it. Click on it, and a dropdown menu will open. On it, you’ll have multiple device options. Click on them in order to preview your content in that format.
This allows you to verify that your portal is multi-device friendly, which is important for the users, as well as for appropriate ranking with search engine optimization.
To use the Filerobot DAM API, you will need to create an API key from Settings > Developers > API keys. This API key must be passed as X-Filerobot-Key header in all API requests.
Each API key is associated with a set of permissions governing which actions a key is allowed to perform on the Filerobot File System.
Access the full API reference in Postman below:
Once you’ve clicked on the “edit” button of your portal, you’ll be logged into the editor. On the top, to the left of the page, you’ll see the name of your portal, followed by “/ home”. Click on “home”, and a dropdown menu will open. Here, you will see all the pages of your portal. You will start with the pre-created pages, to which you will eventually add others created by you.
First, we have the home page. This is your portal’s main page, and as we’ll see later, you may choose its style and layout through the templates.
Next is the “forgot password?” page, readily available for you and your users. You may slightly tweak this page by adding text below or changing the theme from dark to light. All of the pages will be automatically displayed in the brand colors you have selected for your portal.
You also already have the “login as guest,” “login using hub/portal account,” and “registration page” available.
Click on the registration field, and you can edit it by adding a new field, removing non-mandatory fields, or modifying the order of the different fields. The last sentence, “already have an account? Log in” acts as a CTA button; you may modify the text and add a link to whatever you wish in this space. At the bottom, you may always choose to include more information.
In the top menu you also have the “search” option, where you can type specific keywords you’re looking for, section titles, etc. to find the content you’re looking for.
Your company logo, or whichever logo you choose for your portal, will always be displayed on the top left corner of every page within the portal. You can modify it, and to do so, simply click on it, and a modal menu will appear. This will allow you to edit the logo’s “container”.
You may change it, by adding a new image, or simply modify it, through the “fit”, “fill”, “crop”, and “face crop” options available in the “image positioning” bar. You may also choose to add an alt text, which will not modify the visual, but is a recommended step for search engine optimization.
Creating a new page also happens from the top dropdown menu. At the very bottom you’ll see the button “add new page”.
Once you’ve clicked on this button, a modal will appear, allowing you to set the basic elements of your new page. Firstly, you must select the page type, be it a web page, an asset gallery, or a form. Be mindful that this is the only parameter that cannot be modified later. The type of page cannot be changed. Then you may choose the name of your page, you may want to think of a naming convention in advance so that you can easily find and browse through the different portal pages. You will also select the slug and the title of the page. Hit “add”, and the new page will be created and added to the top menu.
You may then move on to editing your new page’s content. You will land on a blank page with the button “+add section”
Once you’ve clicked on the “+add section” button, a modal will open. In it, you’ll see listed on the left all the different section categories. Browse through them and discover the designs available for each one as they’re displayed on the right.
Browse freely among these blocks to construct your page. Once you’ve selected a block by clicking on it, a new modal will open, allowing you to select the name and slug for this new section within your page. Again, be mindful to have a naming convention so that you don’t get lost and you can easily find different sections and pages at any time.
Once you have filled in the information, simply click “add” and the section will be automatically created and displayed. From here on, adding new sections to your page is simple.
Simply click on the “+” button located at the bottom and top of the existing section, and the same modal will appear for you to choose your new block.
You can also add new sections from the sidebar. To the left, click on the topmost icon named “sections”. It will unfurl a new sidebar, where you’ll see displayed all the currently existing sections, and you’ll also be able to click on “+add a new section” directly underneath.
Here you can also easily change the order of the sections by dragging their corresponding sidebar blocks. You can also decide to temporarily hide, delete or rename your section by clicking on the three dots within the section block, next to the name.
The last added section always bears the footer. It will be visible by default. However you may choose to hide it wherever you want by clicking on the three buttons on the top left corner of the section.
You can choose at any time to change the colors of your portal or to change the background of your sections to further personalize them. To change the colors of your portal, navigate to the sidebar menu, where you will find the “design” tab located directly under the “sections” one.
Click on the “design” tab and an additional side menu will open. Here, you will be able to switch between the “dark” and “light” modes thanks to a drop down menu.
You may then switch or change your primary and secondary colors by clicking directly on the colored square and eyeballing a color of your liking or by directly inputting the exact HEX color code of your brand. You can also automatically invert your primary and secondary colors by clicking on the sun and moon icons located at the top left corner of your section.
The color you choose as primary is the main page color. The secondary color will be present in the sections, and the accent color serves to highlight CTA’s and other important elements to catch viewers attention. Next to the color, you can choose its opacity or intensity.
To change your section’s background, navigate to the top right corner of the section block, where you will see several icons. Click the one that resembles a square. When hovering over it with your mouse, the words “add background” will appear.
When clicking on it, a modal will open. In it, you will see a square with the words “add background” yet again. Click on it, and you will open the hub and access your gallery. From here, you may choose the visual that best suits your section and establish it as your section’s background. By default, the “color overlay” box will be ticked in your modal, adding a film to your image to create more contrast and highlight the text. You may uncheck this box and remove the color overlay at any time.
Many of the design blocks available for the different sections contain images. When choosing your block, you will see default stock images to illustrate your page’s design. You may then substitute your own. To do so, click on one of the image containers, and a modal will open.
In it, you can click directly on the image, and the gallery view will open, so you may select your visual. An ALT text will be automatically generated for your image, but you may change it. As mentioned, descriptive, accurate ALT text improves the image’s search engine optimization ranking.
Image positioning
You can change the position of your images within the containers. Simply click on the “image positioning” tab, and a dropdown menu will appear. In it, you can choose to fill the container with your image, to fit the image to the container, to crop an automatically detected face, or to do a personalized crop of the image.
Cropping Tool
The cropping tool allows a personalized and precise display of the image within the container. Choose the “crop” option within the “image positioning” dropdown menu. A modal with the container image will appear. With the aid of a grid, you can crop the image to your liking.
You may adjust the padding of your sections to suit your desires. Navigate to the portal section of your choosing. In the top right corner, click on the “section settings” icon. There, you will be able to adjust the top and bottom padding.
Certain sections will have pre-determined paddings, others won’t, depending on their layout and the content they’re meant to display. For the most part, you will always be able to modify the padding in the manner described above.
You may clone any element of your portal, whether the portal itself, a page, or a section.
To clone a section, navigate to its top right corner and click on the three dots named section options.
Once you have clicked, a dropdown menu will open, and you will see the option “clone” appear in second place. By clicking on it, a modal will open, where you can determine the name and slug of the cloned section. Once you have, click on save, and you’re done!
To clone an entire page, navigate to the top menu. Click on it, and the dropdown menu bearing all your portal’s pages will open. Hover over the page you wish to clone; three dots will appear next to it. Click on them, and several options will appear. Select “clone”.
Once you have, again, a modal will appear for you to choose the name and slug of your new page. Hit save, and your copied page will directly appear in the menu alongside the others!
Finally, access the main page with all the portal previews to clone an entire portal. Here, hover over the portal you wish to clone. Notice the three diets on the bottom right corner of the portal preview, and click on them.
Several options will appear. Select “clone”. The exact modal will open for you to choose a name, and a slug for your portal. Hit save, and your portal will be duplicated with all its contents. You may now access and modify this clone directly from the main page.
You can edit your section’s texts directly within the section. Simply click on the desired text, and an inline editor will appear.
You can type out the text of your choice (by default, the text containers will be filled with lorem ipsum). You can also select from a range of title and paragraph styles, from H1 to H5 and P1 to P5. This will also help your page’s architecture be clearer to search engine crawlers.
You can also bold your text, change the style to italic, or strike it through. You may change the text’s color, or add code. You can also add links to external pages or pages within the portal, or even sections within the portal. You may also choose from a selection of fonts or import your own personalized font.
Filerobot Drupal module
Step 1: Download the latest version from https://www.drupal.org/project/filerobot_by_scaleflex/releases;
Step 2: Extract the zip file in /modules
;
Step 3: In the Drual admin, navigate to Extend / find Filerobot by Scaleflex / Install
Step 1: Run composer require 'drupal/filerobot_by_scaleflex:^1.0'
Step 2: In the Drupal admin, navigate to Extend / find Filerobot by Scaleflex / Install
Activation: You can enable or disable the module;
Token: Your token from the Filerobot Asset Hub;
CNAME: If you have a CNAME configure in Filerobot Asset Hub, you can enter it in this field;
Security Template Identifier: To load the Filerobot Widget or Filerobot Image Editor, you need to create a Security Template in your Filerobot Asset Hub first. This will grant your Drupal instance the necessary credentials to access your storage;
Filerobot upload directory: The directory in your Filerobot account where the files will be stored.
You need to click Update widget to load the image after choosing the image from the Filerobot widget.
The Canva plugin allows you to create using all the power of Canva along with any existing templates and designs you already have saved, and transport your final render into your Filerobot library.
Simply follow the below steps:
Click the Upload button (1), and select the Canva option (2)
Then login using you usual credentials in Canva and create at will
Finally, click the "Publish" button (3) on the top right corner of the Canva interface
This will transport your creation as a regular asset, added in the current folder with a simple click on "upload" (4) -after any transformation you could wish to execute from the "settings" side panel-
Filerobot x Opencart v4 plugin
The Filerobot Plugin is an extension which adds Asset Management to Opencart.
There are 3 simple steps for enabling the Filerobot plugin on your Opencart admin:
Obtain a Filerobot token (request it here);
Install the Filerobot module for Opencart;
Add your security configuration parameters to access your Filerobot library.
Register for a demo if you don't already have a Filerobot account.
Login to Admin Dashboard
Go to Extensions > Installer and upload the file filerobot.ocmod.zip
Install Filerobot plugin
Navigate to Extensions/Extensions, choose Modules from the drop-down menu, select Filerobot and update all configurations.
Filerobot Token: Your Filerobot token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Developers top menu;
Filerobot upload directory: This is the top storage folder for your assets.
Please create the folder in Filerobot first to prevent error.
You need to enable the extension in order to use Filerobot in all pages.
With Ckeditor:
With Image field:
If you are on Ckeditor: You can select multiple images for insertion.
If you are in an Image Field: You should select only one. If you selected multiple items, it will use the last one, as Opencart's Image Field inserts only one image at a time.
This extension is 100% compatible with the default theme.
If you use another theme (stock or custom), you should verify that the image is indeed from Filerobot before returning data to the view. An examples for banners would be:
Filerobot Opencart plugin
The Filerobot Plugin is an extension which adds Asset Management to Opencart.
There are 3 simple steps for enabling the Filerobot plugin on your Opencart admin:
Obtain a Filerobot token (request it );
Install the Filerobot module for Opencart;
Add your security configuration parameters to access your Filerobot library.
Currently, the plugin supports the default WYSIWYG editor from Opencart - Summernote, but the native "Image resize" function is disabled. You can change the image size by removing the previous one then add it with new dimensions (a dedicated function will be added in the next version).
if you don't already have a Filerobot account.
Upload the admin
folder in upload/admin
to your Opencart source code.
Login to the Admin Dashboard, navigate to Extensions/Installers and upload the scaleflex_filerobot.ocmod.zip
file. Then, go to Modification and click Reload to update the installer.
Navigate to Extensions/Extensions, choose Modules from the drop-down menu, select Filerobot and update all configurations.
Filerobot Token: Your Filerobot token from the Asset Hub interface;
Security Template Identifier: Security template ID, found in the Developers top menu;
Filerobot upload directory: This is the top storage folder for your assets.
Please create the folder in Filerobot first to prevent error.
You need to enable the extension in order to use Filerobot in all pages.
With Summernote:
With Image field:
If you are on Summernote: You can select multiple images for insertion.
If you are in an Image Field: You should select only one. If you selected multiple items, it will use the last one, as Opencart's Image Field inserts only one image at a time.
This extension is 100% compatible with the default theme.
If you use another theme (stock or custom), you should verify that the image is indeed from Filerobot before returning data to the view. An examples for banners would be:
Scaleflex DAM Wordpress plugin
The Scaleflex DAM WordPress Plugin allows integration of Scaleflex DAM with your WordPress website.
The plugin allows you to interact with your WordPress database and upload or access media assets from within the Scaleflex DAM.
You only need to have a Scaleflex DAM account and install the plugin in your WordPress site.
If you are new to Scaleflex DAM, here is a short introduction:
Plugin:
Or
Step 1. Log in to your WordPress admin panel
Step 2. On the Admin sidebar, navigate to Plugins > Add New.
Step 4 - Enter "Scaleflex DAM" in the search field and then install the plugin
Step 5 - Activate (it will not modify yet your current configuration or image source & delivery)
Step 6 - Navigate to the Scaleflex Settings page
Step 7. Fill-in the plugin's settings page with authentication parameters
CNAME: You can set a custom domain. When some clients' images on Scaleflex DAM are redisplayed and they don’t want the Scaleflex DAM’s domain to appear in the images' URLs, then it's possible to set it there.
Scaleflex DAM token: The token (project ID) that you signed up for, from Filerobot.
Scaleflex DAM upload directory: Which "root" folder do you want to upload to on the Filerobot platform.
“Don’t store media assets on WP server” checked means not to store the size-variants of an image on the “local” WP CMS. The original image is however still stored on the WP CMS.
“Use Scaleflex Media Asset Widget as gallery” checked means only use Scaleflex DAM as the Media Gallery/Uploader. The default WP Media Gallery will therefore be hidden.
“Synchronize Scaleflex DAM metadata” checked means this option will import the metadata available in Scaleflex DAM (tags, etc.) in your image description and alt text to facilitate search. Warning: This option is mandatory for advanced editors (like Elementor, Gutemberg, etc.).
“Sync Post ID” checked means this option will sync all post ID are using the asset to a specific metadata field.
“Sync metadata fields” checked means this option will import the specific metadata fields in Scaleflex DAM with the selected metadata fields chosen in the setting. Warning: This setting needs a specific set of metadata in Scaleflex DAM to be activated, otherwise will break the synchronization. And “Name of the metadata list in WP database” is required if this option checked.
The “Test connection” button tests if your Scaleflex DAM token and Security Template Identifier can connect to your Scaleflex DAM asset library.
The “Synchronization status” button tells you how many files still needs to be synchronized from WP CMS to the Scaleflex DAM platform (the “up”) and how many files still need to be synchronized from the Scaleflex DAM platform to WP CMS (the “down”).
The “Trigger synchronization” button starts the actual synchronization.
For example, before Scaleflex DAM is installed and activated, you have these 2 images on your WP CMS and these 2 images on your Scaleflex DAM platform:
At this point, the images' URLs still have WP CMS URLs
After you install, activate, and configure Scaleflex DAM, you can first check the connection to Scaleflex DAM. This will confirm if you entered the correct credentials.
Then you can check the status of what is yet to be synchronized:
Then you can do the actual synchronization:
The progress bars will give you information about the current synchronization process
The logs tab will show you more information about the synchronized media assets.
Now you can see that all the images' URLs had became Scaleflex DAM URLs
and on Scaleflex DAM platform
The next major feature that Scaleflex DAM brings is: the Scaleflex DAM Widget in the Media Library
Here you can upload your media assets to the Scaleflex DAM platform (instead of WP’s local library)
The next major feature that Scaleflex DAM brings is that: anywhere where the Media Manager opens, a Scaleflex DAM tab will be inserted into it.
The next feature that Filerobot brings is it’s image editor, instead of WP’s image editor
Deactivation
When you deactivate Scaleflex DAM, all the media assets that have been synchronized to Filerobot will be removed.
From Jan 2022: We enabled the Media files' metadata sync:
FR meta -> WP meta,
FR tags -> WP alt,
FR comments -> WP contents
From Jan 2022: Scaleflex DAM plugin only works with these settings:
June 2022: All English. No more Multilingual, language strings, etc …
The Scaleflex DAM WordPress plugin works well with other popular plugins:
Classic Editor
Gutenberg Editor
WooCommerce
Elementor
ACF
... but let us know if you have any compatibility issues with third parties plugins; as WordPress is a very open system, it is always possible that some plugins overwrite part of the configuration.
Filerobot Akeneo connector app
The Filerobot Akeneo app offers the following features:
One Filerobot token supports only one Akeneo EE Instance. One Akeneo EE Instance however can use multiples Filerobot tokens
Metadata sync locales and code of metadata need to match.
Asset Manager
Medialink Type only: Link Sync
Akeneo Entity Reference
Image Type: Binary sync
Text type: Link sync
Size setting
Support at family level (Asset Manager), Entity level (Entity Reference) for specific Scope and Locale
Metadata sync to Attribute
Support Global
Support value per locale
You need an active Filerobot account. if you don't already have one;
Your Akeneo plan needs to be Enterprise Edition.
You need to login to Filerobot Hub first
After login to Akeneo, navigate to Connect / App Store and Find the Filerobot by Scaleflex App
Then click Connect: You will redirected to the Filerobot Asset Hub and will be able choose which token you want to use for your Akeneo EE instance
Each Token can be used for only one Akeneo EE Instance
Multiple Akeneo instance can use the same Token
After selecting your token and clicking Active, you will redirected back to Akeneo
Then please Confirm that you give App access to the Akeneo EE instance
After confirmation, you will be redirected back to Filerobot
Choose to go to Setting
View the Asset Library
1. General Settings
General setting
Enable / Disable: If disabled, you cannot use Akeneo Sync feature on Filerobot
Default size: Default image size will be used if there are no config related to each asset
Default function: Crop or Fit
Please click Apply change to update configuration
After updating the settings, please refresh the Filerobot browser page
Size settings: please see the size section below
Sync all setting / Best fit for newcomers
How does it work?
Can be duplicated
Priority: Bottom to Top, and it will apply the first matching setting only
Example: An Asset with these information:
Scope: commerce / Locale: en_US / Family: filerobotmedia
Will try to match setting following the steps bellow:
First try: Type: Asset / Family: filerobotmedia / Scope: commerce / Locale: en_US
Second try: Type: Asset / Family: All Items / Scope: commerce / Locale: en_US
Third try: Type: Global / Scope: commerce / Locale: en_US
Use default setting
Add new
(1) To add new size setting Click Add new size on the top right
Explanation
(1) Type, currently The app support 3 types
Global: Affect all asset include entity and asset
Asset: Asset Family
Entity: Entity Reference
(2) If we choose Asset or Entity, we can also choose which attribute family(asset manager) or entity(entity reference) will be applied this setting
We can also choose All Items to apply to all Family / Entity
(3) / (4) Scope and Locale
To choose locale you muse choose a scope first / can choose No Scope
There are 4 cases can happen:
(5) / (6) Function and Size
Function: Crop and Fit
Size of asset to be resized
Must follow format: widthxheight, example: 300x400
Edit / Delete
(1) Click on Edit on each setting
Same as Add new
(2) You can Delete by click Delete button on opened Modal
(1) On each Asset / Click Detail
(2) You can choose which type to sync
Entity: Entity reference
Asset: Asset Manager
(3) On Sync Asset Tab
Choose Family or Entity
Choose attribute(For entity support two types: Text(Link sync) and Image(Binary Sync)
There are 4 cases can happen:
Value per channel and value per locale are both false: Can sync without choose scopes or locales
Value per locale is true, value per channel is false: Must choose at least one locale
Value per locale is false, value per channel is true: Must choose at least one scope
Value per channel and value per locale are both true: Must choose at least one scope and locale
Entity Code(Entity Ref): Code -> You can search for old code, or create new one.
(4) To check sync history, Click Sync Logs
(5) You can see which locales and scopes were synced by click View on Each item
Only support attribute with following settings:
Value per locale: true / Value per channel: false
Value per locale: false / value per channel: false
Configuration step:
(1) Go to store config
(2) In Regional variants, Add new group
(3) Option setting
(3.1) Name of Group - Can be anything you want
(3.2) / (3.3) Code of Locale / Must match the setting in Akeneo / See picture bellow
Metadata setting
(1) Click to manage, Metadata tab, you can add new Group then Add new field
(2.1) API Value must match (3.1) Attribute code(in Entity / Asset Manager Family)
If (3.2) is uncheck then (2.2) is None else (2.2) must specific a Regional variants group as we did above with Same setting as Akeneo locales
How to sync
After configuration, everything is automatic for the mapping between two systems
On each Asset detail(1) you can see Metadata tab(2), You can change value by locale or value only(if value per locale is false)(3) , then click Done(4) to save the value
You must close the asset popup and open again to make new metadata available to sync(5)
Filerobot Commercetools connector app
Nginx
PM2
Nodejs > v16.10.0
Certbot
To install the Filerobot module, please follow the steps below:
1. Download the latest version
2. Upload and unzip to the server at your domain path (Ex: /var/www/public_html/)
3. Configuration Commercetools & Filerobot plugin
4. Go to the source folder and run "npm install", "npm run build" (this command will build and create a folder public)
5. Go to the folder public and run "pm2 serve --spa".
6. Config your domain, port you will run with Nginx and create SSL with Certbot For example, config with port 8080
Configure the Filerobot module as follow:
For Commercetools project:
Clone file custom-application-config.example.mjs and rename to custom-application-config.mjs
Input your Commercetools configuration
Set your entryPointUriPath at src/constants.js
For Filerobot module:
Clone file filerobot-config.json.example in folder "src" and rename to filerobot-config.json
Input your Filerobot token, SEC, upload directory, and any other options as fitting.
In left-menu, select Scaleflex DAM > Products
In this page select your product variant need to upload/update image
To add new image, click on "Add Image" in view page Variant Detail
Select image on the widget and click on "Insert" button to add the image.
Note: You can select multiple images.
Filerobot Sylius plugin
if you don't already have a Filerobot account.
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
This command requires you to have Composer , as explained in the installation chapter of the Composer documentation.
Then, enable the plugin by adding it to the list of registered plugins/bundles in config/bundles.php file of your project:
To configure the Filerobot Sylius plugin, the following components need to be updated:
Create file in config/routes/scaleflex_sylius_filerobot.yaml
with the following content:
Change form theme {% form_theme form '@ScaleflexSyliusFilerobotPlugin/Admin/Form/imagesTheme.html.twig' %}
in your templates/bundles/SyliusAdminBundle/Product/Tab/_media.html.twig
Change grid thumbnail column template
Create a file config/packages/scaleflex_filerobot.yaml
and add content bellow
Navigate to Configuration / Scaleflex Filerobot
You can enable the plugin only if both token and security template id are correct.
Activation: Enable/Disable Filerobot plugin
Filerobot Token: Your Filerobot token, unique Filerobot Project and gallery identifier
Security Template Identifier: Your security template ID, found in the "Developers" section of your Filerobot admin
Filerobot upload directory: (sub)folder path to your asset's gallery, eg. /my_sylius_folder
The Filerobot plugin offers various Twig methods and filters to assist developers:
is_filerobot(image_path)
: Twig function which checks if an image is stored in Filerobot;
image_path|filerobot('sylius_shop_product_thumbnail')
: A resizing Twig filter; More filters can be added in in config/package/scaleflex_filerobot.yaml
.
and in Twig
We have some default size follow Sylius default, you can override it in filter config above
If you use Scaleflex Filerobot on existing File you have to check the path is filerobot or not, if not use the default way
Example with Sylius default
templates/bundles/SyliusShopBundle/Product/_mainImage.html.twig
templates/bundles/SyliusShopBundle/Product/Show/_mainImage.html.twig
:
Filerobot Shopware module
if you don't already have a Filerobot account.
Step 1: Download the latest version
Step 2: Rename the Zip file with the name filerobot.zip
Step 3: In Admin go to Extensions / My extensions / Upload extension
Step 1: In Admin go to Extensions / Store / Catalog and search for "Filerobot by Scaleflex":
Step 2: Select the extension and choose Add extension:
Step 3: Go to Extensions / My extensions / Filerobot by Scaleflex - Digital Asset Management, Media Optimisation and Acceleration / choose Configuration:
Step 4: Update the configuration and activate the Module and your site is ready to go:
Admin access key ID: Need to generate in "Setting" to call API in Admin Dashboard;
Admin secret access key: Need to generate in "Setting" to call API in Admin Dashboard;
Folder Id: This key will auto generate when the plugin activate;
Activation: Enable/Disable the module;
Token: Please enter your Filerobot token here (eg: abcdefgh);
CNAME: Enter the CNAME as per the configuration done in your Filerobot Asset Hub interface, once validated and the SSL certificate is accepted. (Or leave blank if none);
Security Template Identifier: To load the Filerobot Widget or Filerobot Image Editor, you need to create a Security Template in your Filerobot Asset Hub first, in order for your Shopware instantiation of the Filerobot Widget to obtain proper credentials and access your storage;
Filerobot upload directory: The directory in your Filerobot account, where the files will be stored.
The step to get "Admin access key ID" and "Admin secret access key":
Please note that this plugin is directly developed and maintained by the team.
This integration allows business users to build personalized landing pages and applications by repurposing content from your digital asset management system. It also enables developers to use their preferred front-end tools to build these applications.
Make assets housed in Scaleflex Filerobot available to the by adding this integration.
Log into Scaleflex Filerobot Hub.
Note Container Id string to the left from your account icon at the top right corner. You will need this value in the next section.
Click on the Settings icon top right corner of the screen.
Scroll to the tab Development section.
Click on Security templates link.
Create a new template if not created yet.
Note the Secret Key of your template. You will need this value in the next section.
In Uniform, open your project.
Navigate to the Integrations tab.
Scroll to the section Browse Integrations.
Click Scaleflex Filerobot.
Click Add to project.
Enter the required values:
Click Save.
After you install the Scaleflex Filerobot integration, new asset library becomes available.
You can manage your Scaleflex Filerobot assets from inside Uniform. Uniform leverages its Media Widget to provide access to your library throughout your project.
Integrate Hygraph with Filerobot by Scaleflex to bring in and manage your digital assets seamlessly from the DAM as the Single Source of Truth.
With this application, users can upload, store, edit, manage, optimize, enrich and automate their media assets right within their Hygraph UI, saving time and better enhancing their workflow.
Publish your Media Assets directly from within Hygraph with the Filerobot Media Asset Widget:
As Original
: This option is available for all assets. Adds them to the content entry as is as preview or downloadable element.
As Transformation
: This option is only available for image assets. It lets you modify the image format, quality, size, and even crop part of it.
This integration is developed and maintained by our partner Hygraph.
Useful resources:
General information:
Installation guide:
Hygraph community (slack):
Filerobot Shopify app
The Filerobot x Shopify App can be installed from the .
to be helped adding the App to your store.
Have a Filerobot Asset Hub account, with the Filerobot App installed. If you don't have an account yet, please to get one;
Create the Security Template Identifier (SEC) to use the app (Setting > Security templates > )
You already have a store on Shopify.
From Shopify, open the Filerobot app in the Apps menu item and click the button “Configuration”
Fill-in your Filerobot token, CNAME (not required), Security Template Identifier (SEC), Upload Directory (not required, the default will be "/"), and “Save”
Add Filerobot snippets to your theme: In modal Configuration, click the button “Update Snippets” to update or create new Filerobot snippets in your theme store.
Add product webhooks for action create/update/delete, that will check and update images to Filerobot Hub when the user has action create/update/delete.
In Shopify, open the Filerobot app from the Apps menu item.
Click the button “Sync All Product Media”, the process will run in the background for a few minutes depending on the number of images on your store, the process will download all product images from Shopify and store them on Filerobot Library.
Fill in your product name you need to "Sync"
You can add Filerobot images to your site by editing your theme's code.
The snippets provide the functionality to display images on your site
filerobot-image-tag.liquid: Builds an image tag with multiple sources to render product images on your site lazily, applying transformations.
filerobot-product-media.liquid: Uses filerobot-image-tag to render product images on your site, with optional transformations.
filerobot-url.liquid: This will help you build a Filerobot URL to deliver an image on your site with any transformations that you want to apply.
You can use these snippets in your theme's code, referencing them in other snippets or sections.
You can use filerobot-image-tag.liquid or filerobot-url.liquid to display Filerobot image on your page
First we need assign variable fr_metafields
Example:
To render image tag
Example:
To get Filerobot image url
Example:
Require:
Configuration your application in Shopify
Install the Product Webhook
Copy the image URL in Hub and paste the URL to the column Image Src in the CSV file. After that, you can use the function "Import" on the Products page to update the product with your CSV file.
Example file:
When Shopify import is done, the Filerobot webhook will convert the image links from Shopify CDN to Filerobot CDN link.
A versatile command-line interface tool for seamless server-side interaction with the headless DAM API
The Filerobot CLI is a command-line interface tool designed to interact with the Filerobot API. It enables server-side use and provides a convenient way to perform various operations on digital assets, such as uploading, downloading, deleting, moving and renaming files. Additionally, it allows users to list and query asset information, including tags and metadata.
The Filerobot CLI provides all the functionality of Filerobot and its APIs. It can be used from the terminal or in a script to access the features of Filerobot in a convenient way. Using the tool, all media assets can be managed via simple commands on macOS or Linux.
For example, you can perform Admin and Upload API operations by typing commands directly into a terminal. This saves you time as you do not need to set up a development environment. You can also build scripts with multiple CLI commands to implement more complex processes and workflows.
Complete documentation of the tool is available on its GitHub page:
What follows is a brief introduction and a quick-start guide to get you up to speed in no time.
The Filerobot CLI provides a range of use cases that demonstrate its versatility:
Bulk upload - Upload a large number of assets to the DAM in a single command, saving time and effort;
Automated workflows - Incorporate the CLI application into server-side scripts or workflows to perform scheduled asset management tasks;
Asset manipulation - Rename, move or delete assets based on specific criteria;
Metadata management - Query and update asset metadata;
Backup and recovery - Download assets from the DAM for backup or recovery purposes;
Integration with other systems - Integrate the CLI into third-party tools or systems for seamless asset management.
The features of Filerobot CLI include:
Uploading/Downloading multiple assets;
Batch asset deletion;
Listing assets;
Querying asset information such as metadata, tags, etc.;
Moving assets between folders;
Renaming assets.
The following Filerobot APIs are supported: Delete, Download, Inspect, List, Move, Product, Rename and Upload.
Complete information about the Filerobot API endpoints is available in an always up-to-date documentation, that can be accessed via the following link:
There, you can find details about the API endpoints, together with all required request parameters, so you know how to interact with them.
Filerobot API can be installed by running one of the following commands depending on your operating system. They download the latest release of the tool from the GitHub page, move it to an appropriate directory and make it available for use.
You can confirm that the installation was successful by running:
The version of the tool should appear on the screen:
Configuring the CLI requires a Filerobot Token (mytoken) and API Secret Key (mysupersecretkey) both of which are available from the Filerobot Asset Hub.
The following commands are available:
Additional info for any command can be accessed using filerobot [command] --help
.
Inspect the current token and key:
List the contents of a directory:
Inspect a specific resource:
Download a file by UUID:
Upload a file to a specific folder:
Upload all .jpg images in the current directory:
if you don't already have a Scaleflex DAM account.
Scaleflex DAM token: The token (project ID) you signed up for, from Scaleflex DAM.
Security Template Identifier: It’s like a way to obtain limited-time passwords. See: . Behind the scenes, the code would use the Security Template Identifier to obtain a SASS (the “limited-time password”). The SASS would then be used in the auth header for interacting with the Scaleflex DAM API ()
Filerobot upload directory: Which "root" folder do you want to upload to on the Filerobot platform?
Navigate, browse, and search for your Scaleflex DAM image and video assets for your Canva designs.
Drag and drop to add the image/video to your design.
Step 1. On Content Type Menu
Step 3. Save and Close
Step 4. On Your Entry open Filerobot and choose image Step 5. Publish
Step 1. On Content Type Menu
Step 2. Select Scaleflex Filerobot
Step 5. Publish
if you don't already have a Filerobot account.
Security Template Identifier: It’s like a way obtain limited-time passwords. See: . Behind the scenes, the code would use the Security Template Identifier to obtain a SASS (the “limited-time password”). The SASS would then be used in the auth header for interacting with the Filerobot API ()
Navigate to Settings / Developement / Akeneo PIM to open the Setting page. Alternatively, you can follow this
The App | Akeneo |
---|
Get the applicationId and entryPointUriPath of Commercetools
Uniform setting | Value |
---|
You can insert assets directly into your Uniform using .
Note: Read more about attribute optimizer following this
To import multiple images you need to follow the document of Shopify:
Command | Description |
---|
No Scope + No Locale | Value per locale: False Value per channel: False |
Scope + No Locale | Value per locale: False Value per channel: True |
No Scope + Locale | Value per locale: True Value per channel: False |
Scope + Locale | Value per locale: True Value per channel: True |
Container Id | Your Filerobot container id (aka token). |
Security templates secret key | Security templates are meant to be used by frontend applications calling the Filerobot DAM API directly or via the Filerobot Media Asset Widget. |
| sets the token and key provided by Scaleflex, required to use the tool |
| deletes a file by UUID |
| downloads a file by path or UUID |
| displays the help info for a command |
| gets file information by UUID |
| lists files and directories from your Filerobot store |
| moves files to a new folder. The folder is created if it doesn't exist |
| allows access to the Product API functionalities |
| renames a file by UUID. |
| uploads a file to a specific folder |
| prints the version number of Filerobot CLI |
Automations allow you to apply automatic actions (background removal, auto-tagging, brand recognition, etc.) to assets during or after the upload process. It is also possible to send the uploaded asset's details to external API endpoints.
Some of the key capabilities of the Widget are:
Single and multi-file uploads into a Filerobot storage container (project)
Optimized for mobile
Upload via Drag & Drop or Copy & Paste
Upload from 3rd party storages such as Google Drive, Dropbox, OneDrive, Facebook, Instagram
Webcam and screencast integration to upload real-time videos and screen recordings
File explorer and media gallery with file management capabilities (folder creation, file move, rename, ...)
Zipped download of multiple files
File versioning with history, version browsing
File and media asset sharing via accelerated CDN links
Media gallery with powerful search capabilities based on tags and customizable metadata (taxonomy)
AI-based tagging of images
Embedded Filerobot Image Editor for inline image editing
Image annotator and comments for collaboration
Image variant generator with customizable template to generate optimal sizes for social media posts (example)
Native support of Blurhash from our friends at Wolt for compact representation of a placeholder for an image
Post-upload video transcoding for delivering HLS & DASH playlists for adaptive streaming
On-the-fly image resizing via Cloudimage
A demo page of the FMAW with all modules enabled is available here.
Scaleflex announces the EOL (End Of Life) of the Filerobot Widget release v2
The milestone events, descriptions, and dates are shown below.
Customers with active Support contracts will continue to receive support from the Scaleflex Support, per the terms and conditions specified in the support contract.
In order to avoid any inconvenience or disruption of Services, we recommend to our Customers having implemented the Filerobot Widget v2 to migrate to the v3.
Status
Phase 1 - migration plan layout, no new features developed for v2 (until February 1st, 2023)
Phase 2 - POCs and final version (until August 1st, 2023)
Phase 3 - v2 no longer supported (September 30, 2023)
Step by step tutorial
All Widget functions and APIs for v2 version should remain compatible, however some advanced and new features will not be available unless the Widget used in the custom implementation is migrated to v3.
Be aware that no further developments will be published for the v2 Widget version, from February 1st 2023.
Please refer to the relevant NPM repository for more detailed instructions: LINK
Have a Kontent CMS setup. https://kontent.ai/
Add custom element
Content model (left hand side) > Create new > Custom element (right hand side). You will then have the below view.
**Hosted code URL: https://scaleflex.cloudimg.io/v7/plugins/filerobot-kontent/filerobot-custom-element.html?func=proxy
Parameters:
note: "dir" element is optional, by default will go to the root folder of your library. Do not add "/" at the end of the directory string.
Create new content with this Custom Element
Content & asset (left hand side) > Create new > Chose type: Your_Type_Name. Chose and add some images, publish. You will then have the below view.
The images below are the images added in from the Widget into a Kontent content-item. When they are added, they will have Filerobot-URLs (instead of their Strapi CMS URLs).
Tutorial: https://kontent.ai/learn/tutorials/develop-apps/build-strong-foundation/set-up-preview/
Go to Settings > API Keys. For this, you will definitely need your Project ID. You may also need your API Key (depends on what you want to do, but for simple things Project ID is enough).
Write a client app that utilizes the Delivery API
Recall that Kontent have 3 set of APIs that you can interact with
Delivery APIs in plain HTTPS form can be downloaded from https://kontent.ai/learn/tutorials/develop-apps/get-started/postman-collection/ and imported into POSTMAN
For the 3 content items that comes out of the box, Kontent already have an example client app, which we can imitate.
This example app was made by using React JS https://github.com/kontent-ai/sample-app-react
Hosted on various Github Pages.
After writing and hosting your client app, go to Settings > Preview URLs and define your Preview URL formats.
See how Kontent defined their preview URLS for their example app
Codename
, URLSlug
& ItemId
are obtained as follows:
Once you done all the above, you can preview by clicking Preview
https://scaleflex.zendesk.com/hc/en-gb/requests/new or hello@scaleflex.com
Filerobot Zapier integration
Zapier connects over 3,000 different tools, applications, and services you need to manage your business. Their simple integration platform allows anyone to seamlessly integrate Filerobot with other applications to automate workflows.
The Filerobot integration allows to:
Setup a trigger when a new file is uploaded to Filerobot (useful for setting up notifications, transforming uploaded files or using other tools)
Upload new files to Filerobot
Transform files in Filerobot (this is done by adding transformation functions to the file CDN link)
Search for existing files and folders
Create folders
Start a new Zap and add a tool to start the trigger with. It can be Filerobot or any other tool. Filerobot can either start the Zap or execute the actions for the trigger coming from other tools, as shown in the example below.
Once the Filerobot trigger/action is added, you will be asked to "Choose account" to connect to Filerobot.
New browser window will pop up asking for authentication details to Filerobot Asset Hub.
Filerobot Token can be found in the Filerobot Asset Hub project selector and next to the project title. While Filerobot API Secret Key is available in the Developers menu in the Filerobot Asset Hub. Make sure the API Secret Key has the minimum required permission for the actions of the Zap.
Once done, you have successfully connected your Filerobot account to your Zapier account.
After the account is successfully configured and authenticated, you will be able to set up the triggers and actions for execution.
When selecting the Folder Path, if you leave it as a default option, it will only do actions on the Home folder of your Filerobot account. When looking for a specific folder, you can add the folder path manually or use the search function for exiting folders in the Home folder path.
A modern asset uploader, picker and modular gallery with embedded image editor to deliver modern media asset-centric experiences
The FMAW is a file uploader and media gallery in one easy-to-integrate modal or inline widget. It is the storefront of the Filerobot DAM and enables accelerated uploads through Filerobot's content ingestion network and reverse CDN.
The modular architecture of the FMAW allows to enable only the needed modules (see #od_05f3da56) to address multiple use cases for accessing and managing your media asset library from your web or mobile application.
It is optimized for mobile and can be used to upload media recorded with a mobile device camera.
Trigger API calls on events, automate workflows and collaborate effortlessly
Webhooks are a powerful feature used in modern web development and API integrations. They provide a way for applications to communicate and exchange data in real time.
They enable users to trigger API calls to third-party endpoints upon specific events and send relevant asset's information.
The concept behind webhooks is based on the "push" model of communication, where data is actively sent to a predefined endpoint as opposed to the usual "pull" model, where applications need to request data from a server actively.
In the context of Filerobot, webhooks allow users to integrate external systems, automate workflows and stay informed about changes and more generally actions performed on their assets. When a relevant event takes place, such as a new file upload, file renaming or file movement, the webhook is triggered and a POST request is sent to a third-party endpoint, providing details about the the affected asset.
This mechanism allows seamless connections with other applications which enhances collaboration capabilities.
Using webhooks simplifies the delivery of personalized notifications or alerts to assigned recipients whenever essential actions are executed on critical assets. This facilitates prompt responses and efficient communication.
They can also be integrated with project management tools to automatically create tasks, assign responsibilities and track progress whenever assets are uploaded to or moved within the DAM.
The webhook settings can be accessed from the Developers / Automations / Webhooks menu.
In order to set up the webhook, the following information must be provided:
Hostname - The domain name of the third-party API that will be contacted.
Path - The specific path that together with the Hostname forms the complete target URL (Webhook URL) to which the data will be sent.
A consumer cannot always verify that the webhook it is receiving is actually coming from the expected source. Due to this, there are two authentication methods supported:
Basic authentication - The simplest way to verify a webhook. It makes use of a username
and a password
that are used for authentication when sending the data to to the Webhook URL.
OAuth2 authentication - A more secure and complex authentication method that allows users to grant limited access to their resources without exposing their credentials. This type of authentication can be used in two ways:
By specifying the Authentication endpoint
, username
and password
to retrieve a temporary token which is then used in the webhook.
By directly entering the Static bearer token
to use every time without generating a temporary one before the request.
You can specify up to 10 additional headers to be sent to the endpoint with the payload. Those headers will have the classic form "name":"value",
The triggers determine the events that need to happen in order to execute the webhook. The following ones are available:
On upload - After a successful asset upload.
On move - When the asset location is changed.
On rename - When the asset is renamed.
On delete - When the asset is deleted.
On change meta - When any metadata field is modified.
On change info - When some asset's information (e.g. title, description, etc.) is changed.
On change tag - When the asset's tags are edited.
On change label - When the asset's labels are modified.
There is a fine-grained control over which specific asset details are sent as part of the request JSON body to the selected API endpoint. This ensures that only the necessary information to handle the event effectively is communicated. Those details are divided into several categories, depending on the asset type:
Filerobot Pabbly integration
Pabbly connects more than 800+ software products for seamless real-time data transfer. Their simple integration platform allows anyone to seamlessly integrate Filerobot with other applications to automate workflows.
You can request for demo if you don't have a Filerobot Account.
After logging in Filerobot, you need to login to Pabbly Connect.
In the Actions seaction, search for Filerobot by Scaleflex.
Choose Action Event or Trigger Event from the drop down input and confirm with Connect:
You can find your token and the API key in Filerobot Asset Hub: Developers / API Secret Keys.
Once you save your Token and API key, you don't need to enter it again for another action event by selecting "Select Existing Connection" option.
Triggers are events that occur in FIlerobot and that events data are sent to Pabbly. Filerobot Pabbly connector has the following triggers:
Filerobot Pabbly connector has the following actions and corresponding inputs:
Automate and enhance asset management with custom tasks, triggered on asset upload
Upload post processes are actions that are triggered for a given asset upon its upload into Filerobot. Post-processing involves running various algorithms and ML models on an asset (e.g., detecting if it contains inappropriate content, counting the number of faces in an image, determining the dominant colors, removing the image background, and many others).
Post process tasks are automated actions that can be performed in two modes:
Synchronous - The results are evaluated before accepting the upload and returned in the response. The use of this mode is generally preferred in user-generated content (UGC) scenarios where user-uploaded images and videos must be moderated automatically based on a number of pre-defined criteria.
Asynchronous - The results are evaluated in the background (in a non-blocking manner) after the file has been uploaded. In some cases, depending on the specified post process type, the result will be appended to the asset's information, tags or metadata.
The following table is a summary of all available post process actions:
Process | API name | Supported modes | Description |
---|---|---|---|
Post processes marked with a * require ASK Filerobot credits in order to be executed
Additional details are available on the tasks' respective pages in the Scaleflex Visual AI section
The post process settings can be accessed from the Developers / Automations / Post processing menu.
When a post process automation task is activated, it will run automatically on each upload. If not activated, the task can be manually triggered for certain uploads via the Upload API using the postprocess parameter (e.g., postprocess=remove-background
).
It is possible to specify trigger rules when setting up a post process. These are conditions which must be met in order to activate the related task. If left empty, the task will be run on each upload.
Trigger rules are evaluated no matter if the task is run manually or automatically.
The following variables may be used to construct rules:
As mentioned, the synchronous tasks provide a mechanism to validate uploads using validation rules. Possible actions when conditions have been met are:
Refuse - The upload is rejected.
Notice - A notice is issued, added to the file information and returned in the API response.
Setting up many synchronous tasks might slow down the upload process significantly.
Prismic Headless CMS integration
Instead of using the /list
endpoint (API documentation), this API supports Prismic's format directly.
This endpoint lists the assets with the following settings:
50 elements per pages
ordered by last_update
GET {API_SECRET_KEY}@api.filerobot.com/{TOKEN}/integration/prismic/assets
Parameter | Description |
---|---|
Copy-paste the cURL request in your Terminal to see the API in action.
The response format will look like this:
Where:
results_size is the total counting of the listing result; and could be easily understood as the sum of size(results)
of all pages, while each page contains a maximum of 50 files.
image_url is fixed to be resized to 100x100
description would be returned as a concatenation from blob->meta->search
and blob->meta->tags
and the parsed list of directories and sub-directories. In case the file doesn't have this field (and is at the root folder), it defaults to No description for this file is available
.
Installing the FMAW library happens over npm.
The FMAW consists of the Filerobot Core package and additional modules described below. The modules marked as required must be imported for the FMAW to function.
File (All assets) | Video | Image |
---|---|---|
Trigger Name | Description |
---|---|
Action Name | Description | Inputs |
---|---|---|
Process | API name | Supported modes | Description |
---|---|---|---|
Property | Asset type | Description | Example |
---|---|---|---|
Process | Validation rule | Example |
---|---|---|
Name
Width
Width
Size
Height
Height
Path
Length (in seconds)
MIME type
Bitrate
CDN link
HLS/DASH playlist URL
File UUID
File Upload
It is fired when a new file is uploaded to Filerobot.File details are sent.
File Upload
Used to upload remote hosted files to filerobot
Origin File Url,File name
File Delete
Delete file from Filerobot
File UUID
File Rename
Used to rename file.
File UUID,File new name
Folder Create
Create new folder in Filerobot.
Folder path
Folder Delete
Delete folder in Filerobot
Folder UUID
Folder Rename
Rename folder in Filerobot
Folder UUID,Folder new name
Folder List
Lists all folders details
(N.A.)
Calculate blurhash
blurhash
async
Generates a blurhash (compact representation that can be used as a placeholder) of the image. The result is added to the asset's information.
Count faces
face-count
sync / async
Returns the number of face(s) detected in the image. Can be used for classification or to ensure the presence / absence of face(s) upon upload.
Extract brand logo *
brand-detect
sync / async
Detects the presence of logos from a database containing thousand of popular brands. The list of recognized brands is included in the file information.
Extract dominant colors
dominant-color
sync / async
Analyzes the image and returns a palette consisting of the most prominent colors in the image.
Index for face clustering *
face-clustering
async
Adds the image to an index for face clustering.
Index for image similarity search
image-similarities
async
Adds the image to an index for similarity search.
Not Safe For Work *
nsfw
sync / async
Detects adult or explicit content within the image.
Plate number blurring *
plate-blurring
async
Finds and automatically blurs vehicle license plate numbers in the image.
Recognize number plate *
plate-recognition
sync / async
Detects and recognizes car license plates in the image. The result is included in the asset information.
Recognize text (OCR) *
ocr
sync / async
Extracts any text readable in the image.
Remove artifacts (Quality improvement) *
remove-artifacts
async
Removes any JPEG artifacts and improves the quality of the image.
Remove background *
remove-background
sync / async
Removes the background of the image. Useful for products, portraits, etc.
Scene classification *
scene-classification
sync / async
Detects scene categories, attributes and type of environment in the image.
Sport classification *
sport-classification
async
Detect if the provided image depicts a sport activity and add its name to metadata.
Tag with AI *
autotag
async
Performs automatic tag generation for the image.
Validate image properties
image-properties
sync
Validates if the image meets any number of predefined criteria.
Compress video *
compress
async
Changes the video bitrate and resolution.
Convert video *
convert
async
Converts the video file to another format.
Transcode video *
transcode
sync
Converts the video into adaptive streaming formats (HLS/DASH).
Trim video *
trim
async
Trims the video file based on provided time intervals.
Validate video properties
video-properties
sync
Validates if the video meets any number of predefined criteria.
Image/Video width (px)
images / videos
Horizontal image dimensions / frame size (in pixels).
Image width (px) is smaller than 500
Image/Video height (px)
images / videos
Vertical image dimensions / frame size (in pixels).
Video height (px) is larger or equal than 200
Image format
images
The file type of the image.
Image format contains PNG, JPEG
File size (B)
images / videos
The size of the asset in bytes.
File size (B) is larger than 5000000
Video bitrate (bps)
videos
The video bitrate in bits per second.
Video bitrate (bps) is smaller than 1500000
Video duration (s)
videos
The video duration in seconds.
Video duration (s) is larger than 60
Upload folder path
images / videos
The location in which the asset is getting uploaded.
Upload folder path starts with '/users'
Count faces
Number of faces
Number of faces is smaller than 1 => Refuse
Not Safe For Work
NSFW
Drawing
Hentai
Neutral
Porn
NSFW is larger than 0.70 => Refuse
Recognize number plate
Number of characters in number plate
Number plate content
Number plate content does not start with 'C' => Notice
Recognize text (OCR)
Text contains
Text contains 'Copyright' => Refuse
Validate image properties
Image/Video width (px)
Image/Video height (px)
Image format
File size (B)
Upload folder path
Image width (px) is smaller than 500 => Notice
Validate video properties
Image/Video width (px)
Image/Video height (px)
File size (B)
Video bitrate (bps)
Video duration (s)
Upload folder path
Video bitrate (bps) is smaller than 800000 => Refuse
API_SECRET_KEY
can be generated in the Asset hub (documentation)
TOKEN
your Filerobot token
folder
the path to the folder you would like to list default: /
page
the result page number, starting from 1 default: 1
Module
Required
Description
yes
Displays the folder structure and media gallery and provides file management capabilites.
yes
Handles multipart file upload.
no
Displays upload/download progress in a status bar.
no
Displays pop-up messages/statuses related to file operations.
no
Thumbnail generator for different file type previews.
no
Inline image editor with functionalities such as filters, crop, resizing, watermark, collages, etc.... Also used by other features of the Widget such as the variant generator and export function.
no
Inline image annotation and comment feed for people to collaborate on media assets.
no
Captures photos or videos from the device's camera and upload them to the Filerobot storage container.
no
Device screen recorder and uploader
no
Inline image editor prior the actual upload of the image to, for example, upload a resized version of a large image into the storage container.
Framework
Link to code snippet
React
Vanilla (plain) JS
The creation of a portal starts within your Filerobot hub. Once you’ve logged in, navigate to the top left corner of the main page. Here, you’ll see three tabs displayed, named “library”, “portals” and “analytics”.
Click directly on the “portals” hub to access the main area of operations of your portals. Here, you’ll be able to see all the portals you have created. If you haven’t yet created any, the page will be blank. To start creating your first portal, navigate to the top right corner of the page, where you’ll see the button “+add a new portal”. Click on it, and start creating!
Once you have clicked on “+add a new portal” a modal will open. Through it you’ll be able to set the main elements of your portal. Choose the portal name, set a slug, determine a primary language, choose a theme (light or dark) as well as its primary colors. Everything can be modified later on.
When you are satisfied with the parameters you have set, simply click on the “add” button, and the new portal will be created and displayed in the main page.
*If the “portals” tab doesn’t appear, contact your hub administrator to be granted access.
Now that you have created your portal, you can get down to editing and modifying it as you wish. From the main page, you have access to everything you need. Hover over your portal’s thumbnail, and you will see three main elements: an “edit” button and a “publish” button right in the middle, and three small dots in the bottom right corner. We will go through these elements one by one.
Let’s start by diving into the “settings” section, which can be found by clicking on the three buttons on the bottom right corner. Be mindful that only those hub users that have at least a manager’s access will be able to access the portal admin section. You will see different options when clicking on this button: “Settings”, “users”, “clone”, and “delete”.
Click on the “settings” button to access a new menu, through which you’ll be able to, at any time, modify the name of your portal as well as its slug. Here you can also determine a preview image for your portal.
Scrolling further down on the “settings” page, you’ll come upon the access settings for your portal. In this section, you may determine whether your portal is “public” or “private”. As a default, your portal will be set to “private” upon creation and will require identification. When the settings are set to “public”, anyone with the link may access your portal. Nevertheless, You can request a password to have some control over exactly who views the portal. This setting is ideal when your portal’s intent is to be shared with external users and stakeholders.
Conversely, you can decide to change the portal settings to “private”, in which case the access to the portal is much more limited and controlled. This option is perfect when your portal will be shared only internally, or with few external users and stakeholders. When the “hub users” option is enabled, all users, regardless of their level, can access the portal. When disabled, only manager and administrator-level users can access the portal. Similarly, when the “portal users” section is enabled, you can share the portal registration page with external users and through self-registration they can enjoy access to the portal. Finally, in this section you can decide to change the owner of the portal. Ownership of the portal will automatically be attributed to its creator unless changed. Ownership of the portal is relevant as only the owner can delete the portal.
You can access the users section directly through the three dots on the bottom right corner of your portal preview, or from within the settings section, in the tab right next to it.
This is the section where you can view the users of your portal. You will see that each user has a differently colored tag that classifies them. Let’s go through the different categories. “Active” members are those that can currently access and view the portal. “Pending” members are the ones who have requested access through the self-registration. After the self-registration, they receive a link via email to access the portal. The user will remain as “pending” until they click on said link. Their status will then be changed automatically to “active”.
This is also where you may search for specific users by using the search bar to directly type their names. You can also type specific attributes to view the corresponding users. You may also choose to use the drop-down menu right next to the search bar, where you may filter users by type so you can view admins, active users, pending users, etc.
Every user displayed on the user page has a number of associated user attributes that are defined and edited directly through the hub. This is a task only owners or administrators can carry out. It is done directly via the Filerobot Hub main page. Once on the main page of the hub, click on the settings icon located in the top right corner. A drop-down menu will open, and you can click on the first option, “users”. Once on this page, you will see three small dots next to the search bar. Click on it, and you will see a “manage user attributes” button. As you click on it, a modal will open, through which you can edit said attributes. There are some mandatory attributes that need to be filled out for every user, indicated with a lock. You may add as many attributes as you wish on top of the mandatory ones.
At this stage of creation, the portal has not yet been published and will not be visible when clicking on the slug. To render it visible and thus be able to preview your work, click on the green button “publish” that appears when hovering over your portal preview. Don’t worry; you will still be able to edit your portal once it’s been published.
Since a preview functionality isn’t yet available for portals, you can make use of the live link in order to preview changes and edits. Click on the link at the bottom of the preview card and access the portal live.
The edit button appears right next to the “publish” one in blue, or in the case of an already published portal, next to the “unpublished” button, in gray. Click on it to start creating content or to modify the existing content of your portal.
Scaleflex DAM x Strapi plugin
To get Scaleflex DAM integrated you will need to set up these 2 components:
Scaleflex DAM plugin: https://github.com/scaleflex/strapi-plugin-filerobot/blob/v4/README.md;
Filerobot upload-provider: https://github.com/scaleflex/strapi-provider-upload-filerobot/blob/v4/README.md.
Benefits:
All your media will be hosted on Scaleflex DAM;
You have the option to synchronize all your existing media to Scaleflex DAM;
You will have access to the Filerobot Media Asset Widget (FMAW), where you can upload media to Scaleflex DAM and select media from Scaleflex DAM.
Additional workflows or enrichments can be performed from the Filerobot Hub UI
Register for a demo if you don't already have a Scaleflex DAM account.
Install the Scaleflex DAM plugin and you should see Scaleflex DAM in the left menu.
The following options are available to you:
Then, install the Filerobot upload provider. Every media you upload will have Filerobot URLs:
Upload media to Scaleflex DAM:
Select media from Scaleflex DAM:
Beginning with 2 local images
And 10 images on Scaleflex DAM
Synchronize
Note: Please don't close the browser tab until the sync process is done.
Results
Scaleflex DAM Storyblok App
Register for a demo if you don't already have a Filerobot account.
Sign up to Storyblok.
You can find the Scaleflex DAM in the Storyblok Marketplace, clicking the Visit Website button will link to this page containing all instructions.
Note that requesting an installation delegation can be done via our contact form or our support email hello@scaleflex.com, and finally using our regular support page.
Make sure you complete, in any case, each of the following steps fully:
Send us the installation delegation request, including
Add (invite) our Plugins Installation team to your Space
Our support team will contact you back to confirm the installation date and make sure you have everything configured properly to start using the Scaleflex DAM plugin.
Once this is done, you will be able to find the new block in your "Block Library" under the name "Filerobot" and be ready to go!
Depending on your level of support and onboarding plan, a CSM can assist you for the next steps: setup and configuration.
You have 3 required configuration items to take from the Asset hub: Token (the unique project or library identifier), Security Template (this will be used as the secret for authentication), Directory (where you want Storyblok's assets to be stored and retrieved from, usually a dedicated sub-directory; note that this field must be comprised under the directory limit of the Security Template you have selected) And there are optional fields: limit, attributes
You can add as many blocks containing the Filerobot field type as needed. There is no limit on the number of blocks you can include.
Go to Block Library -> New Block
Enter any Technical Name you want, Select Nestable Block -> click "Add Block"
In the side modal "Edit [Technical Name]" that appeared, enter any name as Field (eg. Filerobot_Asset), then select the type of field as plugin -> click "Add"
Click on the field just added (in the "General" section below), then scroll down to the Plugin Options, then choose "filerobot-storyblok" in the Custom Type drop-down. Add the 3 configuration keys you gathered from the Filerobot Hub and set up like below:
token = Token from Filerobot (aka project identification code),
secTemplate = Security template from Filerobot,
rootDir = Base directory (also in the security template configuration).
limit (optional) = number of files you can show when choose on Filerobot Asset
attributes (optional) = add more data on API Response Structure (ex: meta, tags, owner),
limitType (optional) = File Type Filtering ( ex: image, video, audio, application, application/zip, application/x-zip-compressed, application/vnd.rar, application/x-rar-compressed )
Note: Show full Metadata just work if token has permission List project configuration, default it just show title and description
Below are the 3 configuration steps illustrated:
In any Content, type Edit Page
Click Add Block, Choose the Block contain the Filerobot Field you want to add to the Page:
It is now possible to interact with your Filerobot library assets directly from Storyblok:
# | Action | How to |
---|---|---|
1
Add Assets
2
Reorder
Drag and drop to sort assets
3
Remove Asset
On each added Asset -> Click the Bin icon to remove one Item
4
Remove all Assets
To remove (delete) all Assets, click the red "Remove all assets" in the top right corner.
1/ Click Add Assets 2/ Asset picker modal: Choose any asset(s) you want to insert 3/ On top of the modal: Click Insert 4/ Result
This tab allows users to view and add written comments or graphical annotations on assets for better collaboration. Various features such as liking, answering, quoting another user or team are available.