Note: You are currently viewing documentation for Moodle 3.3. Up-to-date documentation for the latest stable version of Moodle is probably available here: Tags block.

Tags block

From MoodleDocs
Note: The tags block will be disabled by default when you upgrade to 3.0 if you have previously used it to tag courses. See details below


A very effective way of viewing all tags is in a tags block, or a "tag cloud".

A unique feature of tag clouds are that the size of each tag is related to the number of items associated with it. The larger the tag, the more items associated with it.

Tag Cloud2.png

Adding a tags block to a course page

  1. Click the "Turn editing on" button.
  2. Select tags from the Add blocks menu.
  3. If appropriate, move the tags block up and/or left, using the arrow icons under the block title.

The tags block may be configured via the edit icon in the block header.

Site administration settings

The tags block may be enabled or disabled by administrator in Administration > Site administration > Plugins > Blocks > Tags.

Tags functionality must be enabled on the site, see Tag settings.

Course tagging changes in Moodle 3.0

Before Moodle 3.0 the Tags block had a site-wide setting "Show course tags". Enabling this setting completely changed the look and behaviour of the Tags block. The setting was removed in 3.0 and the functionality replaced with course tagging (see forum post with detailed reasoning). In order to prevent unexpected change for users who used, it the whole block is disabled during upgrade. When the block is disabled, all instances remain in the courses but become hidden. This does not affect users who did not have "Show course tags" enabled and used Tags block to display tag cloud.

Editing course Tags (Course settings page)

You can enable the block again in Site administration > Plugins > Blocks > Manage blocks. Please note that all instances will become visible again but will now display tag clouds. Therefore it is recommended to go through affected courses and delete instances if you don't need them. If you want to delete all instances at once, you can uninstall and re-install the Tags block plugin.

To continue using course tagging please review the users' roles assignments and make sure the same people who previously had moodle/tag:create capability now have moodle/course:tag capability. The contexts and default role assignments of these two capabilities are different.

We hope that this change will be very useful for a lot of users and the extra effort during upgrade is worth it.

See also