Our /meta/write Robot

Write metadata to media

🤖/meta/write writes metadata into files.

Note: This Robot currently accepts images, videos and audio files.

Usage example

Add a copyright notice to uploaded images:

{
  "steps": {
    "attributed": {
      "robot": "/meta/write",
      "use": ":original",
      "data_to_write": {
        "copyright": "© Transloadit"
      },
      "ffmpeg_stack": "v6.0.0"
    }
  }
}

Parameters

  • use

    String / Array of Strings / Object required

    Specifies which Step(s) to use as input.

    • You can pick any names for Steps except ":original" (reserved for user uploads handled by Transloadit)

    • You can provide several Steps as input with arrays:

      "use": [
        ":original",
        "encoded",
        "resized"
      ]
      

    💡 That’s likely all you need to know about use, but you can view Advanced use cases.

  • data_to_write

    Object ⋅ default: {}

    A key/value map defining the metadata to write into the file.

    Valid metadata keys can be found here. For example: ProcessingSoftware.

FFmpeg parameters

  • ffmpeg_stack

    String ⋅ default: "v5.0.0"

    Selects the FFmpeg stack version to use for encoding. These versions reflect real FFmpeg versions. We currently recommend to use "v6.0.0".

    Supported values: "v5.0.0", "v6.0.0".

    A full comparison of video presets, per stack, can be found here.

Demos

Related blog posts