.. _add-tags-to-a-course:

##############################
Add and delete tags on courses
##############################

.. tags:: educator, how-to

Adding Tags from the Course Outline Page
****************************************

#. On the Course Outline page, click on "Manage Tags" in the course header section.

   .. image:: /_images/educator_how_tos/ctag_course_tag_step1a.png
      :alt: Screenshot of clicking Manage tags.

   The tag drawer will open.

   .. image:: /_images/educator_how_tos/ctag_course_tag_step1b.png
      :alt: Screenshot of tag drawer opening.

#. Click “Edit Tags”.

#. Click in the “Add a tag” field.
   
   .. image:: /_images/educator_how_tos/ctag_course_tag_step3.png
      :alt: Screenshot of clicking in the Add a tag field.

#. If you know the tag you would like to add, start typing the tag in the “Add a tag” field and matches will display.
   
   .. image:: /_images/educator_how_tos/ctag_course_tag_step4.png
      :alt: Screenshot of field matches displaying beneath the Add a tag field.

#. If you don’t know the tag you would like to add, scroll through the list of tags until you find the tag you would like to add.

   .. note::

      Tags may be nested as subtags, and that clicking on the arrows will open any nexted tags.
   
   .. image:: /_images/educator_how_tos/ctag_course_tag_step5.png
      :alt: Screenshot of arrows next to tags with nexted subtags.

#. Once you have decided which tag you would like to add, click on the checkbox next to the tag. Add as many tags as you would like. 
   
   .. note:: 
      
      Choosing a nested tag will automatically add its parent tag(s) as well. 
   
   .. image:: /_images/educator_how_tos/ctag_course_tag_step6.png
      :alt: Screenshot of parent tags being automatically added.

#. When you are finished, click “Add tags”. You will see the newly added tags in the tag drawer view.
   
   .. image:: /_images/educator_how_tos/ctag_course_tag_step7.png
      :alt: Screenshot of added tags in the tag drawer.

#. Click save and close out of the tag drawer. You will see the tag count updated in the Manage Course Tags field.
   
   .. image:: /_images/educator_how_tos/ctag_course_tag_step8.png
      :alt: Screenshot of the tag count under the Course tags field.

Deleting Tags from the Course Outline Page
******************************************

#. Click on “Manage Tags” in the course header section. The tag drawer will open. 
   
   .. image:: /_images/educator_how_tos/ctag_course_tag_del_step1.png
      :alt: Screenshot of clicking Manage tags.

#. Click “edit tags”.

#. Click the “x” button next to the tag you wish to delete.
   
   .. warning:: 

      If you delete a tag that is nested underneath another tag, all tags in the hierarchy will delete.
   
   .. image:: /_images/educator_how_tos/ctag_course_tag_del_step3.png
      :alt: Screenshot of x button next to tag.

#. Click “save” and close the tag drawer. You will see the tag count updated in the Manage Course Tags field.


.. seealso::
 

 :ref:`build-taxonomy-using-template` (how-to)

 :ref:`create-flat-taxonomy` (how-to) 

 :ref:`import-export-taxonomy` (how-to)

 :ref:`Update/Re-import a taxonomy` (how-to)

 :ref:`tag-ids-for-taxonomy-import` (concept)
 
 :ref:`Manage Permissions on a Taxonomy` (how-to)

 :ref:`Add and delete tags on course content` (how-to)

 :ref:`Export tag data from a course` (how-to)

 

**Maintenance chart**

+--------------+-------------------------------+----------------+--------------------------------+
| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
+--------------+-------------------------------+----------------+--------------------------------+
| 2025-03-19   | UX/UI WG                      | Sumac          | Small grammar error - fixed    |
+--------------+-------------------------------+----------------+--------------------------------+