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 name Description
uuid Unique identified of the file
size The size in bytes of the file
info Properties of the file. For images, we automatically add the size (width and height) as well as the image format (img_type)
meta Metadata. Used to store the file's tags, and any custom metadata fields you want to add for later use
description Description of the file
url.public Public URL to access the file, identified by its filename
url.permalink Public URL to access the file, identified by its uuid
url.cdn Public 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.