wagtail/docs/editor_manual/documents_images_snippets/collections.rst

Collections
~~~~~~~~~~~

Access to specific sets of images and documents can be controlled by setting up ‘collections’. By default all images and documents belong to the ‘root’ collection, but users with appropriate permissions can create new collections through the **Settings -> Collections** area of the admin interface.

.. image:: ../../_static/images/collections_list.png

Add a collection
________________

* Clicking the **add a collection** button will allow you to create a collection. Name your collection and click **save** .

.. image:: ../../_static/images/collections_create_collection.png

Add images / documents to a collection
______________________________________

* Navigate to the **Images** or **Documents** section and select a collection from the dropdown menu.

.. image:: ../../_static/images/collections_create_collection_upload_images.png

.. image:: ../../_static/images/collections_add_to_collection.png

* You can also edit an image or document directly by clicking on it to assign it to a collection.

.. image:: ../../_static/images/collections_edit_img_view.png

Privacy settings
________________

* To set permissions determining who is able to view documents within a collection, navigate to **Settings > Collections** and select a collection.  Then click the privacy button above the collection name.

.. image:: ../../_static/images/collections_privacy_button.png

* Within the privacy settings overlay, select the level of privacy for the collection.

.. image:: ../../_static/images/collections_privacy_overlay.png

.. Note::
    Permissions set on a collection apply to that collection and all collections below it in the hierarchy. So if you make the 'root' collection private, all documents on the site will be private.