Documentation

Configuring Asset Auto Tagging

Tagging assets is a great way to organize content. Typically, the content creator manually applies tags during creation, but you can configure Liferay to tag content automatically. For example, you can scan an image on upload and apply tags that describe the image’s content.

Note

Currently, auto tagging only works for images, text-based documents, text-based web content, and blog entries. See Auto Tagging Assets and Auto Tagging Images for more information.

Auto tagging is enabled by default. You can configure it at three levels:

Global (System Settings): Enable or disable auto tagging for the Liferay server. For auto tagging to function on any level, it must be enabled globally. At the global level, you can also set a default configuration for all virtual instances.

Virtual Instance (Instance Settings): Override auto tagging configurations set at the global level. This setting determines the default configuration for all instance sites.

Site: Override auto tagging configurations set at the global and instance levels.

By default, asset auto tagging is only triggered when content is created. Beginning with Liferay 7.4 U36/GA36, you can configure virtual instances to allow auto tag assets on updates as well. See Virtual Instance Scope Configuration for more information.

Global Scope Configuration

  1. Open the Global Menu (Global Menu), click the Control Panel tab, and go to System Settings.

  2. In the Content and Data section, click Assets.

  3. Under System Scope, click Asset Auto Tagging.

    In Site Settings, click Assets and go to the Asset Auto Tagging tab under System Scope.

  4. Check the box to enable or disable Asset Auto Tagging globally.

  5. Set the Maximum Number of Tags that can be added automatically to an asset. Setting the value to 0 means there is no limit.

  6. Click Save when finished.

To set the default auto tagging configuration for all instances, select Asset Auto Tagging under Virtual Instance Scope. The available settings are the same as those in the System Scope.

Virtual Instance Scope Configuration

When enabled globally, auto tagging is also enabled by default for each Virtual Instance. You can, however, disable or configure it for each instance.

Follow these steps to configure Auto Tagging at the Virtual Instance scope:

  1. Open the Global Menu (Global Menu), click the Control Panel tab, and go to Instance Settings.

  2. In the Content and Data section, click Assets.

  3. Under Virtual Instance Scope, click Asset Auto Tagging.

    In Instance Settings, click Assets and go to the Asset Auto Tagging tab under Virtual Instance Scope.

  4. Check/Uncheck Enable Asset Auto Tagging.

  5. Check/Uncheck Update Auto Tags. If unchecked, auto tagging is only triggered during asset creation and upload. If checked, auto tagging is triggered when assets are edited.

  6. Set the Maximum Number of Tags that can be added automatically to an asset. Setting the value to 0 means there is no limit.

  7. Click Save when finished.

Once saved, this determines the default configuration for the current virtual instance. If you’ve enabled the Update Auto Tags feature, editing supported assets triggers auto tagging. If desired, you can disable this behavior for existing content items.

You can disable update auto tagging for individual content items if desired.

Site Scope Configuration

  1. Open the Site Menu (Site Menu), expand Configuration, and go to Site Settings.

  2. For 7.4+, go to Assets under Content and Data and click the Asset Auto Tagging tab.

    Go to Assets under Content and Data and click the Asset Auto Tagging tab.

    For earlier versions, go to the General tab and expand the Asset Auto Tagging section.

  3. Use the toggle to enable or disable auto tagging for the site.

  4. Click Save.