.. _Enable the Poll Tool:

Enable the Poll Tool
########################

.. tags:: educator, how-to

This section describes how to include polls in your course.

.. contents::
   :local:
   :depth: 2

*********
Overview
*********

You can include polls in your course to gather learners' opinions on various
questions.

For a poll, you configure one question and multiple possible
answers. If you need to ask multiple questions, use the :ref:`Survey Tool <Manage Survey Tool>`.

The following example poll has four possible answers to the question.

.. image:: /_images/educator_references/poll_tool.png
    :alt: The poll component in Studio, showing the default example poll.
    :width: 400

After learners submit their answers to the poll question, they see the poll
results that have been gathered at this time, unless the poll has been
configured to hide results.

.. image:: /_images/educator_references/poll_with_results.png
    :alt: A poll showing results after the learner has submitted a response.
    :width: 400

Enable the Poll Tool
*******************************************

Before you can add a poll to your course, you must enable the poll tool in
Studio or OLX (open learning XML).

To enable the poll tool in Studio, you add the ``"poll"`` key to the **Advanced
Module List** on the **Advanced Settings** page. (Be sure to include the
quotation marks around the key value.) For more information, see
:ref:`Enable Additional Exercises and Tools`.

.. seealso::
 

 :ref:`Add Poll` (how to)

**Maintenance chart**

+--------------+-------------------------------+----------------+--------------------------------+
| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
+--------------+-------------------------------+----------------+--------------------------------+
| 2025-03-20   | Documentation WG              | Sumac          | Pass                           |
+--------------+-------------------------------+----------------+--------------------------------+