manual/grease_pencil/properties/data.rst

@@ -18,6 +18,12 @@ Grease Pencil
 Strokes can be grouped in 2D layers, a special Grease Pencil layers
 that help to organize the drawing order and visibility of the strokes.
 
+:doc:`Layer Groups </grease_pencil/properties/layer_groups>`
+================================================
+
+Layers can be organized into layer groups. This helps to get a better overview
+when a file contains a lot of layers. Groups can be hidden and locked just like
+layers.
 
 :doc:`Onion Skinning </grease_pencil/properties/onion_skinning>`
 ================================================================

manual/grease_pencil/properties/layer_groups.rst

@@ -0,0 +1,46 @@
+.. _bpy.types.GreasePencilLayerGroup
+
+************
+Layer Groups
+************
+
+.. reference::
+
+   :Mode:      All Modes
+   :Panel:     :menuselection:`Object Data tab --> Layers`
+   :Shortcut:  :kbd:`Y`
+
+.. figure:: /images/grease-pencil_properties_layers_panel.png
+   :align: right
+
+   Grease Pencil Layers panel.
+
+The :doc:`Layers </grease_pencil/properties/layers>` in a Grease Pencil objects can be
+grouped into a Layer Group.
+
+A layer can only be in one group at a time.
+Layers can be moved into groups using drag-and-drop.
+Groups can be color coded with a color tag.
+
+Layer Tree
+   :ref:`Tree view <ui-tree-view>` of all layers and groups for the Grease Pencil object.
+
+   Next to the group name there are four icons buttons that control common properties of the group:
+
+   Use Mask (mask icon)
+      Toggle the affect of :ref:`Masks <bpy.types.GreasePencilLayer.use_masks>` on all the layers inside the group.
+
+   .. _bpy.types.GreasePencilLayerGroup.use_onion_skinning:
+
+   Onion Skinning (onion skin icon)
+      Toggle using the layers inside the group for :doc:`Onion Skinning </grease_pencil/properties/onion_skinning>`.
+
+   .. _bpy.types.GreasePencilLayerGroup.hide:
+
+   Hide (eye icon)
+      Toggle all the layer visibility of this group in the viewport and in render.
+
+   .. _bpy.types.GreasePencilLayerGroup.lock:
+
+   Lock (padlock icon)
+      Toggle all the layers of this group from being editable.

manual/grease_pencil/properties/layers.rst

@@ -22,6 +22,8 @@ The selected layer is the active layer. Only one layer or group can be active at
 When you draw, the new strokes are added to the active layer.
 By default the view order of the layers in the viewport is top to bottom.
 
+Layers can be grouped using :doc:`Layer Groups </grease_pencil/properties/layer_group>`.
+
 Every layer correspond to a channel in the Dope Sheet editor (in Grease Pencil mode).
 See :doc:`Dope Sheet </editors/dope_sheet/modes/grease_pencil>` for more information.
 
@@ -113,7 +115,7 @@ Layer Specials
    Merge Down
       Combine the selected layer with the layer below, the new layer keeps the name of the lower layer.
    Merge Group
-       Combine layers in the active group into a single layer.
+       Combine layers in the active :doc:`Layer Group </grease_pencil/properties/layer_group>` into a single layer.
    Merge All
       Combine all layers into the active layer.