.. _watch-lists:



*************************************************
Watch Lists
*************************************************


The appearance of specific individuals in the video is monitored with a set of default and custom watch lists. 

Records of individuals are assigned to watch lists. Once a watch list is activated, the system will be looking for each person on it during video processing or :ref:`remote monitoring <remote-alerting-search>`.

You can create as many custom watch lists as necessary: wanted, suspects, etc. — subject to your needs.


.. rubric:: In this section:

.. contents::
   :local:

.. _unmatched-list:

Monitoring Unmatched Faces
==================================

FindFace CIBR features a special pre-configured watch list used for monitoring only unmatched faces (faces that do not match any record). This watch list cannot be removed from the system. To edit its settings, navigate to the :guilabel:`Settings` tab. Click :guilabel:`Watch Lists` and then click :guilabel:`Unmatched`.

    |watch_list_unmatched_en|
 
     .. |watch_list_unmatched_en| image:: /_static/watch_list_unmatched_en.png
        :scale: 60%

     .. |watch_list_unmatched_ru| image:: /_static/watch_list_unmatched_ru.png
        :scale: 60%


.. _create-list:

Create Watch List
=================================

To create a custom watch list, do the following:
  

#. Navigate :guilabel:`Settings` → :guilabel:`Watch Lists`.
#. Click :guilabel:`+ Add new watch list`.

    |watch_list_add_en|
 
     .. |watch_list_add_en| image:: /_static/watch_list_add_en.png
        :scale: 60%

     .. |watch_list_add_ru| image:: /_static/watch_list_add_ru.png
        :scale: 60%

#. On the :guilabel:`Information` tab, specify the watch list name.
#. From the :guilabel:`Color` palette, select a color which will be shown in notifications for this list. 

    |watch_list_info_en|
 
     .. |watch_list_info_en| image:: /_static/watch_list_info_en.png
        :scale: 60%

     .. |watch_list_info_ru| image:: /_static/watch_list_info_ru.png
        :scale: 60%

#. Describe the watch list in a comment, if needed.
#. By default, the :ref:`generic confidence threshold <settings>` is applied in all watch lists in the system. To set an individual threshold for the watch list, check :guilabel:`Confidence threshold` and specify the threshold value. 

   .. include:: /_inclusions/threshold_important.rst

#. Enable :guilabel:`Require acknowledgment` if it is mandatory that events associated with the list be manually acknowledged.
#. Enable :guilabel:`Enable sound alert` to turn on sound notifications for the list if needed.
#. (Optional) If you have enabled a :ref:`daily search <daily_search>`, check :guilabel:`Collect data location`, so all records associated to this watch list may receive daily search events.
#. On the :guilabel:`Permissions` tab, assign privileges on the watch list, specifying which user roles are allowed to change/view the watch list settings.

    |watch_list_permissions_en|
 
     .. |watch_list_permissions_en| image:: /_static/watch_list_permissions_en.png
        :scale: 60%

     .. |watch_list_permissions_ru| image:: /_static/watch_list_permissions_ru.png
        :scale: 60%

#. Activate and save the watch list.



.. _remove-list:

Remove Watch List
=================================

To remove a custom watch list, delete records associated with it first. Otherwise, the system will return an error and will not delete the watch list.

    |watch_list_remove_en|
 
     .. |watch_list_remove_en| image:: /_static/watch_list_remove_en.png
        :scale: 75%

     .. |watch_list_remove_ru| image:: /_static/watch_list_remove_ru.png
        :scale: 75%

:guilabel:`Default Watch List` and :guilabel:`Unmatched` watch list cannot be removed from the system.