Combining asset database and scalable object storage

Media assets are stored in the Filerobot File System in the Cloud, a distributed file system combining multi-provider and multi-location object storage and a distributed asset database to keep file information like metadata, asset information and various other parameters needed to build a scalable and flexible file system in the Cloud.

A file stored in the Filerobot File System can be accessed via:{token}/{folder}/{filename}

This URL points to the origin asset in the Filerobot storage. It is not meant to be used on your web or mobile application as it is neither optimized nor delivered over CDN. You should rather use the Filerobot CDN URL, which will deliver optimized and accelerated assets.

You can obtain your {token} by subscribing to a Filerobot account.

Data model

Each file is described in the Filerobot file system using following JSON structure:

  "status": "success",
  "file": {
    "uuid": "1f78b9d1-98fe-53db-82a4-8c9aafb50000",
    "name": "product_0f0.jpg",
    "extension": "jpg",
    "size": {
      "bytes": 4905337,
      "pretty": "4.68 MB"
    "flags": [],
    "type": "image/jpeg",
    "info": {
      "img_h": 3744,
      "img_w": 5616,
      "img_type": "JPEG",
      "visibility": "2"
    "meta": {
      "sku": "SC04-GRLX6",
      "color": [
      "price": "110",
      "title": {
        "de_DE": "Luxusschal",
        "en_US": "Luxury Scarf",
        "fr_FR": "\u00c9charpe de luxe",
        "it_IT": "Sciarpa di lusso"
      "category": [
      "material": "40% silk, 40% Merino wool, 20% cotton",
      "description": {
        "de_DE": "Luxusschal",
        "en_US": "Luxury Scarf",
        "fr_FR": "\u00c9charpe de luxe",
        "it_IT": "Sciarpa di lusso"
      "available_from1": "2021-05-06"
    "tags": {},
    "visibility": {
      "value": "VISIBILITY_INHERIT",
      "inherited": "VISIBILITY_PUBLIC",
      "set": "VISIBILITY_INHERIT",
      "actual": "VISIBILITY_PUBLIC"
    "url": {
      "public": "",
      "permalink": "",
      "cdn": "",
      "path": "/api-demo/product_0f0.jpg"
    "hash": {
      "sha1": "0982ad36c60b87d10105519fce96965a754b67a8",
      "blurhash": "LAGl9k0J0jys?_yE.9Vs4T-oH=I:"
    "created_at": "2021-05-05T15:41:44Z",
    "modified_at": "2021-05-05T16:44:09Z",
    "folder": {
      "uuid": "7610923e-80d0-50e8-a2e4-c509be390158",
      "name": "/api-demo"
    "product": {
      "ref": null,
      "position": null

Most attributes are self explanatory but below is a detailed description of the main attributes you will work with:

Attribute nameDescription
uuidUnique identified of the file
sizeThe size in bytes of the file
infoProperties of the file. For images, we automatically add the size (width and height) as well as the image format (img_type)
metaMetadata. Used to store the file's tags, and any custom metadata fields you want to add for later use
descriptionDescription of the file
url.publicPublic URL to access the file, identified by its filename
url.permalinkPublic URL to access the file, identified by its uuid
url.cdnPublic URL to deliver the file via CDN. This allows media transformations and filters.

Info and Metadata are key:value fields of the file description and are used for search. Metadata can be customized.

Custom metadata

Filerobot offers a robust multi-lingual metadata system to help you organise and classify your assets. You can create custom metadata fields of the following types: numeric, select-one, select-multi, textarea, text, tags, date, and boolean.



With the metadata permission model, your team can collaborate by granting per-field and per-language view and edit permission on a company or user level.

Each metadata field value can be or not be delivered in the asset header in public listings and downloads.

Details on metada, tags and localization can be found under Taxonomy.