---
canonical: https://amplience.com/developers/docs/workforce/flows/examples/image-tagging-upload/
title: Automatic image tagging
description: Learn how to build a Workforce Flow that automatically tags images on upload, using AI to add metadata and streamline your asset management workflows.
audience: Business User
image: https://cdn.media.amplience.net/i/ampproduct/ve-flows-tag-upload-image2-lm?w=1200&h=630
image_width: 1200
image_height: 630
date_published: 2026-01-19
date_modified: 2026-06-26
---

# Image tagging and Content Hub upload

Learn how to build a [Workforce Flow](https://amplience.com/developers/docs/workforce/flows/about-flows/) that:

- Uses AI to tag an image according to a predefined list of tags.
- Uploads the image to Content Hub, along with its tags.

The tags can be used to help classify and organize your images.

![Image tagging and upload flow overview](https://cdn.media.amplience.net/i/ampproduct/ve-flows-tag-upload-image2-lm?w=1880&fmt=png&)

> **Info:** To build Flows you will need the Admin role on the hub. See [Workforce permissions](https://amplience.com/developers/docs/concepts/permissions/roles/#roles-and-workforce).

## Step 1- Create the form trigger

Create a new flow and give it a label and description.

- From the **Action Library** open the **Manual triggers** and drag a **Form trigger** to your flow. Once added, configure the trigger.

![Add the form trigger action used to start the flow](https://cdn.media.amplience.net/i/ampproduct/flow-tag-image-v2-1?w=1880&fmt=png 'Add the form trigger action used to start the flow')

- Click the **Configure Input Form** button and add the following fields:

  - The image to tag: **Image**

  - A single line text field: **Filename**. This will be the filename _including_ the file extension (eg .png, .jpg).

![Configure the form trigger used to start the flow](https://cdn.media.amplience.net/i/ampproduct/flow-tag-image-v2-2?w=1880&fmt=png 'Configure the form trigger used to start the flow')

## Step 2- Auto Detect the tags

The **Auto Detect Tags** action uses AI to process an image, matching the tags that you entered. For each tag, you enter details for when the tag is to be applied. For example, for a tag of "Shoe", the when to apply this tag field could contain "When the image contains a shoe". Or you could be far more specific to just tag particular types of shoe.

- Open the **Image action** section in the **Action Library** and drag the **Auto Detect Tags** action to your flow.

- Connect the action to the output of the **Form Trigger**. This will be the image to process.

![Add the Auto detect tags action to the flow](https://cdn.media.amplience.net/i/ampproduct/flow-tag-image-v2-3?w=1880&fmt=png 'Add the Auto detect tags action to the flow')

## Step 3- Split the filename

When uploading an image to Content Hub, you need to specify the image filename and an API name- this will be the filename without the image. To make this simple, use the **Split File Name** action.

- Open the **Helpers** section in the **Action Library** and drag the **Split File Name** action into your flow.

- Ensure that the **File Path** field is set to the _Filename_ output by the **Form trigger**.

![Add the Split file name helper action to the flow](https://cdn.media.amplience.net/i/ampproduct/flow-tag-image-v2-4?w=1880&fmt=png 'Add the Split file name helper action to the flow')

## Step 4- Upload the asset to Content Hub

To upload the image, including its tags, to Content Hub, use the **Upload Image Asset** action.

- Open the **Amplience Content Hub** folder within **Integrations** in the **Action Library**.

- Drag the **Upload Image Asset** action to your form and connect it with the output of the **Split File Name** action.

- Configure the fields of **Upload Image Asset** (the values are defaulted for you):

  - **Image** - the _Auto Tagged Image_ returned by the Auto Detect Tags action.

  - **File Name** - the _Filename_ returned by the Form Trigger.

  - **API Name** - the _Base Name_ returned by the Split File Name action. This is the Filename without the file extension.

- Ensure that **Add tags to Content Hub** is checked.

![Add the Upload image asset action to the flow](https://cdn.media.amplience.net/i/ampproduct/flow-tag-image-v2-5?w=1880&fmt=png 'Add the Upload image asset action to the flow')

> **Tip: The conflict mode**
> You can also choose the Conflict Mode: Rename unique (the default) or Overwrite. Rename unique will create a unique name for the file if one with the same name already exists, while Overwrite will replace the existing file.

> **Info:** You can run the flow in Test mode straight away, but it needs to be enabled before you or anyone else can run it for general use. Learn more about [Enabling Flows](https://amplience.com/developers/docs/workforce/flows/review/#enabling-flows-to-be-run).

## Try it out

The flow is ready to run once it's [enabled](https://amplience.com/developers/docs/workforce/flows/review/#enabling-flows-to-be-run).

- Click **Run** at the top of the window.

- Upload an image, enter a filename to be used in Content Hub and click the **Start Run** button.

![Run the flow](https://cdn.media.amplience.net/i/ampproduct/flow-tag-image-v2-6?w=1880&fmt=png 'Run the flow')

The image is processed and any matching tags are added. The image is then uploaded to Content Hub with the name you entered.

![The flow in the process of uploading an image](https://cdn.media.amplience.net/i/ampproduct/flow-tag-image-v2-7?w=1880&fmt=png 'The flow in the process of uploading an image')

The image is now in Content Hub and the tags are showing in the properties pane.

![The image uploaded to Content Hub](https://cdn.media.amplience.net/i/ampproduct/flow-tag-image-v2-8?w=400&fmt=png 'The image uploaded to Content Hub')