=========================================
Adding, editing, and deleting node groups
=========================================

Node group records are configured entirely via the management web interface.

.. contents::
    :local:
    :depth: 1

Adding a node group
===================

To add a node group, click the **Add node group** button located underneath the
heading on the node group list page:

|adding-editing-and-deleting-node-groups-1|

From here you can specify the following information. Fields marked with
an asterisk are required.

Name *
------

A descriptive name for the node group.

Space *
-------

The space the node group will be assigned to. The space determines which users
can see and manage the group.

Metadata
--------

Optional data about the node group, in key-value pairs. This is purely
user-defined. It can be used to store data such as location and CRM
identifiers.

Note
----

Any miscellaneous information you would like to include about the node group.

Once you have entered your information, click on **Save** to add the node
group. You will then be directed to the newly created node group's details
page.

Editing a node group
====================

To edit a node group record, navigate to the node group's details page by
clicking on its name in the node group list:

|adding-editing-and-deleting-node-groups-2|

From here you can edit any of the properties of the node group that were
specified when it was created.

To edit the node group's name, click the |edit| button that appears next to the
name when you hover over it:

|adding-editing-and-deleting-node-groups-3|

To edit the node group's space, click the |edit| button that appears next to
the space name when you hover over it:

|adding-editing-and-deleting-node-groups-4|

To edit node group metadata, click the |edit| button next to the **Metadata**
heading in the node group details.

Deleting a node group
=====================

To delete a node group, navigate to the node group's details page and click the
**Delete** button underneath the node group's name:

|adding-editing-and-deleting-node-groups-5|

This will open up a modal asking you to confirm before the node group record is
permanently deleted.

.. |adding-editing-and-deleting-node-groups-1| image:: /attachments/laywire/node-groups/adding-editing-and-deleting-node-groups-1.png
    :scale: 75%
.. |adding-editing-and-deleting-node-groups-2| image:: /attachments/laywire/node-groups/adding-editing-and-deleting-node-groups-2.png
    :scale: 75%
.. |adding-editing-and-deleting-node-groups-3| image:: /attachments/laywire/node-groups/adding-editing-and-deleting-node-groups-3.png
    :scale: 75%
.. |adding-editing-and-deleting-node-groups-4| image:: /attachments/laywire/node-groups/adding-editing-and-deleting-node-groups-4.png
    :scale: 75%
.. |adding-editing-and-deleting-node-groups-5| image:: /attachments/laywire/node-groups/adding-editing-and-deleting-node-groups-5.png
    :scale: 75%

.. |add| image:: /attachments/laywire/add.svg
    :width: 20px
.. |edit| image:: /attachments/laywire/edit.svg
    :width: 20px
.. |delete| image:: /attachments/laywire/delete.svg
    :width: 20px