# <Groups>

The Groups element specifies the group tree, which represents the hierarchical set of group names used to help organize the document elements in the list.

## Full element example

        <Groups>
          <Group name="Personal" checked="yes"/>
          <Groups name="Animals" checked="yes" expanded="yes">
            <Group name="Frogs//Toads"/>
            <Group name="Cows" checked="yes"/>
            <Group name="Dogs and cats"/>
          </Groups>
          <Group name="Work"/>
        </Groups>

## Sub-element summary

Tag | Type | Default | Description
--- | --- | --- | ---
`<Group>` | string | n/a | A group with no sub-groups.
`<Groups>` | string | n/a | A group with sub-groups.

## Sub-element descriptions

### <Group>

Description
The `<Group>` element specifies a group, whose name is given using the `name` attribute. If the name contains a slash, it must be represented with two forward slashes because a single forward slash serves as a path-separator in a group path. The `<Group>` tag may optionally have a `checked` attribute that can take one of the values `yes` and `no`. This attribute is used within user interfaces to indicate whether or not document elements belonging to the checked group are shown.
Examples
This example specifies a group whose name is Work:

      <Group name="Work"/>

This example specifies a group whose name is Personal and is checked:

      <Group name="Personal" checked="yes"/>

The next example specifies a group whose name is Frogs/Toads. Note the use of two forward slashes to represent the single forward slash in the group name:

      <Group name="Frogs//Toads"/>

### <Groups>

Description
The Groups element specifies a group that has sub-groups. Specify the name of the group using the `name` attribute. If the name contains a slash, it must be represented with two forward slashes because a single forward slash serves as a path-separator in a group path. The `<Groups>` tag may optionally have a `checked` attribute that can take one of the values `yes` and `no`. This attribute is used within user interfaces to indicate whether or not document elements belonging to the checked group are shown. Additionally, the `<Groups>` tag may optionally have an `expanded` attribute that can take one of the values `yes` and `no`. This attribute is used within user interfaces to indicate whether or not the sub-groups within the group are shown or not in the user interface component representing the group tree.

Within the `<Groups>` start tag and the `</Groups>` end tag, specify one or more Group or Groups elements to represent the sub-groups.
Examples
This example specifies a group named Animals that has three sub-groups named Frogs/Toads, Cows, and Dogs and cats.

      <Groups name="Animals" checked="yes" expanded="yes">
        <Group name="Frogs//Toads"/>
        <Group name="Cows" checked="yes"/>
        <Group name="Dogs and cats"/>
      </Groups>

©1999-2017 DC & Co. All rights reserved.