.. _About Course Units:

###################################
About Course Units
###################################

.. tags:: educator, concept

One or more units make up a course :ref:`subsection <About Course Subsections>`.
Units are comprised of :ref:`course components<About Course Components>`.

.. contents::
   :depth: 1
   :local:

.. _What is a Unit:

****************************
What is a Unit?
****************************

A unit is a part of a :ref:`subsection<About Course Subsections>` that
learners view as a single page.

A unit contains one or more :ref:`components<Add a Component>`,
such as text with :ref:`HTML<About Text Components>` markup,
:ref:`problems<Working with Problem Components>`, or a
:ref:`video<Working with Video Components>`.


****************************
Viewing the Unit Page
****************************

In Studio, when a unit name is selected in the outline, the **Unit** page opens.

The following example shows a unit page in Studio with one component, with
boxes and text to show different areas and controls in the page.

.. image:: /_images/educator_references/unit-page.png
 :alt: The Studio unit page with numbered indicators.
 :width: 600

#. A unit navigation bar that shows where in the subsection this unit is
   located, and provides easy navigation options to nearby unit pages.
#. Options for testing the unit (View Live and Preview), and button to view
   in-context analytics (if :ref:`Aspects Home` is enabled).
#. Navigation tools to quickly get to other units in the subsection.
#. The **+ New unit** button is a way to add new units to a subsection through
   the unit navigation bar.
#. Status panel for the unit.
#. A component in the unit.
#. The "New Component" section at the bottom of the page, allowing authors to
   add additional components to the unit.

****************************
Viewing Units as a Learner
****************************

To a learner using the learning management system (LMS), each unit in the
subsection is listed in the collapsable navigation bar on the left side of the
**Course** page. The current unit is indicated with slight highlighting in the
sidebar. The components in the current unit appear to the right of the sidebar
navigation.

The following image shows a subsection in the LMS that contains several units.

.. image:: /_images/educator_references/Units_LMS.png
 :alt: A unit in the LMS, with all of the unit icons in the unit navigation sidebar
  indicated. Green check marks are visible for some units.
 :width: 750

A green check mark next to a unit icon indicates that a learner has completed
the unit. A learner has completed the unit if the learner has completed all the
following actions.

* Viewed all of each video.
* Submitted answers for all of the problems.
* Viewed all HTML content for at least five seconds.

.. _Staff Only Unit:

****************************
Setting Units to Staff Only
****************************

To set a unit to be visible to only staff, follow these steps.

#. From the three-dot menu at the unit level, choose **Configure**.

   .. image:: /_images/educator_concepts/unit_three_dot_menu_configure.png
     :width: 600

#. Locate the **Unit visibility** section and select **Hide from learners**.

   .. image:: /_images/educator_concepts/unit_hide_from_learners.png
     :width: 600

#. Select **Save**.

.. seealso::
 
 :ref:`Manage Course Units` (how-to)

 :ref:`Set Access Restrictions For a Unit` (how-to)

 :ref:`Copy and Paste Course Units <Copy and Paste Course Units>` (how-to)

 :ref:`Hide a Unit from Learners <Hide a Unit from Students>` (how-to)

 :ref:`Copy and Paste Course Components <Copy and Paste Course Components>` (how-to)

 :ref:`The Unit Workflow` (reference)

 :ref:`Guide to Course Content Development` (reference)

 :ref:`Create a New Course` (how-to)

 :ref:`About the Course Outline` (concept)

 :ref:`Manage Course Outline` (how-to)

 :ref:`Modify Settings for Objects in the Course Outline` (how-to)

 :ref:`Publish Content from the Course Outline` (how-to)

 :ref:`About Course Sections` (concept)

 :ref:`About Course Subsections` (concept)

 :ref:`Manage Course Sections` (how-to)

 :ref:`Manage Course Subsections` (how-to)

 :ref:`Manage Course Units` (how-to)

 :ref:`View as Learner` (how-to)



**Maintenance chart**

+--------------+-------------------------------+----------------+--------------------------------+
| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
+--------------+-------------------------------+----------------+--------------------------------+
| 2025-11-16   | sarina                        |  Ulmo          | Pass                           |
+--------------+-------------------------------+----------------+--------------------------------+
