Tagging assets is a great way to organize content. Typically, the content creator applies tags while creating the content. It’s also possible, however, to tag content automatically. For example, Liferay DXP can scan an image on upload and apply tags that describe the image’s content. This lets you leverage tags without requiring content creators to apply them manually.
Here, you’ll learn how to configure asset auto-tagging in general. This is required prior to configuring auto-tagging for specific asset types, which is documented separately:
Configuration Levels
Auto-tagging is enabled by default. You can configure it at three levels:
Global (System): For auto-tagging to function on any level, it must be enabled globally. You can also set the default auto-tagging configuration for every portal instance.
Instance: When enabled globally, auto-tagging is also enabled by default for each portal instance. However, you can override the global auto-tagging configuration on a per-instance basis.
Site: When enabled for an instance, auto-tagging is also enabled by default for all that instance’s sites. You can disable it for specific sites.
Global Configuration
Follow these steps to configure auto tagging globally:
-
Go to Control Panel → Configuration → System Settings → Assets.
-
Under SYSTEM SCOPE, select Asset Auto Tagging.
-
The following settings are available:
Enable Auto Tagging of Assets: Whether asset auto tagging is enabled.
Maximum Number of Tags: The maximum number of tags that can be automatically applied to each asset. The default value of
0means that there is no limit. -
Click Save to save your changes.
To set the default auto-tagging configuration for all instances, select Asset Auto Tagging under VIRTUAL INSTANCE SCOPE. The available settings are exactly the same as those in the SYSTEM SCOPE.
Figure 1: You can configure auto tagging globally in the Assets section of System Settings.
Instance-level Configuration
When enabled globally, auto-tagging is also enabled by default for each instance. You can, however, disable or configure it for each instance.
Follow these steps to configure auto tagging on the instance level:
-
Go to Control Panel → Configuration → Instance Settings → Assets.
-
Under VIRTUAL INSTANCE SCOPE, select Asset Auto Tagging.
-
The settings here are identical to those in the global configuration, but apply only to the current instance.
-
Click Save to save your changes.
Figure 2: You can also configure auto tagging for each instance.
Site-level Configuration
When enabled for an instance, auto-tagging is also enabled by default for all that instance’s sites. You can, however, enable or disable it for each site.
Follow these steps to configure auto tagging for a site:
-
Open the Menu (
), click your site’s name, and navigate to Configuration → Settings.
-
In the General tab, expand the Asset Auto Tagging section. Use the toggle to enable or disable auto tagging for the site.
-
Click Save to save your changes.
Figure 3: You can enable or disable auto-tagging for a site.