Detecting general features in images.


Image Tagging is one of the intelligence services of Filestack platform. You can detect general features of uploaded images both synchronously and through the Workflows.

Task Configuration

If you would like to learn how to use the Workflows UI for configuring tasks (and the logic behind them), visit Creating Workflows Tutorial.

Image Tagging task is available in the Intelligence tasks category.


Task Name string Unique name of the task. It will be included in the webhook response and can be used to build logic below.


Image Tagging task returns following response:

  "tags": {
    "auto": {
      "feature_1": 98 "an example of confidence number",
      "feature_2": 82
    "user": null


tags dictionary Contains "auto" and "user" tags.
auto dictionary Includes all of detected general features from the image with their corresponding confidence numbers.

Based on the task’s response you can build logic that tells the workflow how dependent tasks should be executed. For example, if you would like to run another task if a specific task was detected you can use the following rule:

tags.auto kex "sky"

In Workflows UI this command would look like in the example below:

Visit Creating Workflows Tutorial to learn how you can use Workflows UI to configure your tasks and logic between them.


Below is an example webhook payload for an image tagging task. “auto” tags include detected features from the image and their confidence numbers.

    "id": 67376965,
    "action": "fs.workflow",
    "timestamp": 1552312203,
    "text": {
        "workflow": "c516519f-3755-4fb5-85a4-15ae4b31d475",
        "createdAt": "2019-03-11T13:49:54.233362645Z",
        "updatedAt": "2019-03-11T13:49:54.825867826Z",
        "sources": [
        "results": {
            "tags_1552311891723": {
                "data": {
                    "tags": {
                        "auto": {
                            "action": 88,
                            "adult": 95,
                            "battle": 87,
                            "city": 84,
                            "competition": 91,
                            "concert": 88,
                            "crowd": 86,
                            "festival": 95,
                            "fun": 87,
                            "group": 85,
                            "man": 93,
                            "music": 84,
                            "outdoors": 90,
                            "people": 96,
                            "performance": 89,
                            "rain": 96,
                            "street": 85,
                            "umbrella": 97,
                            "wear": 89,
                            "woman": 95
                        "user": null
        "status": "Finished"

Please visit the webhooks documentation page to learn more.