Auto-tagging AI Configurations control how Akeneo PIM's AI automatically generates tags for your asset images. For a broader introduction to AI Configurations in Akeneo PIM, see the AI Configurations Overview.

What auto-tagging AI Configurations do

Auto-tagging AI Configurations in Akeneo PIM give you a way to customize how the AI generates tags for asset images. Rather than relying on default tagging behavior, you create reusable configurations that define which types of tags to include or exclude based on your business needs.

When you enable auto-tagging for an Asset Family, Akeneo PIM's AI analyzes image content and automatically applies relevant tags—saving time and maintaining consistency across your entire asset library. By adding an AI Configuration of type Asset Auto-Tagging, you can customize this behavior with specific instructions, such as excluding brand names or focusing on particular attributes like materials and colors.

Where to access auto-tagging AI Configurations

In Akeneo PIM, auto-tagging AI Configurations are created and managed at Settings → AI Configurations. Once created, you apply them to specific Asset Families at Settings → Asset families, by opening the Asset Family and selecting its Properties tab.

How auto-tagging works

When auto-tagging is enabled for an Asset Family in Akeneo PIM, the AI analyzes uploaded images and automatically generates relevant tags based on visual content. If an AI Configuration is selected for that Asset Family, the AI follows your custom instructions when determining which tags to apply. Tags are stored in the Asset Family's auto-tagging attribute, where they can be reviewed and edited.

What an auto-tagging AI Configuration contains

An auto-tagging AI Configuration in Akeneo PIM contains two main components:

1. General information

Basic identifiers including a label for easy recognition, a unique code, and an enabled/disabled toggle. When creating an auto-tagging configuration, select Asset Auto-Tagging as the configuration type.

2. Instruction prompt

The instruction prompt defines how the AI generates tags for your assets. Specify tagging behavior such as:

• Exclusions: Tags to avoid (e.g., brand names, logos, visible text)
• Focus areas: Specific attributes to emphasize (e.g., materials, colors, product categories)
• Formatting preferences: Tag structure and naming conventions

Example instruction:

Generate descriptive tags focusing on product category, materials, and colors.
Exclude brand names and trademarks. Use lowercase, singular form.

Well-designed prompts produce more consistent tagging results across your asset library.

The screenshot above shows the AI Configurations creation form in Akeneo PIM with the Asset Auto-Tagging type selected and the General Information fields (Label, Code, and status toggle) visible.

The screenshot above shows the Instruction Prompt section of an auto-tagging AI Configuration in Akeneo PIM, where custom tagging instructions are entered.

Applying auto-tagging AI Configurations to Asset Families

To enable auto-tagging for an Asset Family in Akeneo PIM:

1. Go to Settings → Asset families.
2. Open the Asset Family you want to configure.
3. Select the Properties tab.
4. Toggle on the Enable auto-tagging generation option.
5. Select an AI Configuration from the dropdown (optional).
6. Click Save.

If no configuration is selected, Akeneo PIM uses default tagging behavior. The Asset Family must have an auto-tagging attribute to store the generated tags.

The screenshot above shows the Properties tab of an Asset Family in Akeneo PIM with the auto-tagging toggle enabled and an AI Configuration selected from the dropdown.

Why use AI Configurations for auto-tagging

AI Configurations for auto-tagging in Akeneo PIM offer the following benefits:

Consistency Centralized instructions ensure uniform tagging standards across your entire asset library. Create one configuration and reuse it across multiple Asset Families instead of manually defining rules for each one.

Customization Control which tags are generated to match your business requirements. Exclude irrelevant tags like brand names, focus on specific attributes, or enforce naming conventions that align with your taxonomy.

Scalability Once you've validated a configuration, apply it to automatically tag hundreds or thousands of assets while maintaining quality and eliminating manual effort.

Ease of maintenance Update your tagging logic in one place, and the change applies automatically wherever the configuration is used across Asset Families.

Important considerations

• Image quality impacts results: Higher-quality images produce more accurate tags.
• AI Configurations are optional: Auto-tagging works without a configuration, using default behavior.
• One auto-tagging attribute per Family: Each Asset Family supports a single auto-tagging attribute.
• Tags are AI suggestions: Review and validate generated tags for critical business terminology.
• Test before broad deployment: Validate configuration behavior with sample assets before applying across your catalog.
• Credit usage: Tagging operations consume AI credits. If your catalog reaches its credit limit, auto-tagging is paused until credits are replenished.

Next steps

• Create your first auto-tagging configuration in Settings → AI Configurations using the Asset Auto-Tagging type.
• Apply it to an Asset Family at Settings → Asset families, then enable auto-tagging in the Properties tab.
• Review AI Configuration Considerations and Limitations to understand constraints and best practices.