# Manage Organizations

You will need the `Edit IQ Elements` permission to manage organizations in Lifecycle. Organizations may be managed manually or using the [Organizations REST API](https://help.sonatype.com/en/organizations-rest-api.html "Organizations REST API").

## Add an organization

1. Navigate to location for new organization. Select the plus sign (+)
2. Enter the name
3. Use an icons to represent the organization; options include: default image, custom icon, or robot.  
    1. Custom images should be PNG files at 160 x 160 pixels.
4. Select `Create`

|     |
| --- |
|  |

## Editing an organization

1. Click on _Orgs and Policies_ in the left navigation bar. Select the organization you want to edit. The configuration details for this organization are now accessible in the right pane.
2. Click _Actions_ dropdown in the top right as shown below:
3. Select _Edit Org Name/Icon_ from the dropdown list.

In the _Edit Organization_ dialog, you can edit the organization name its associated icon.
4. Click the _Update_ button to save changes.

## Deleting an organization

1. Click _Orgs and Policies_ on the left toolbar and select the organization you want to delete.

Alternatively, enter the name of the organization in the _Filter_ to navigate to the organization you want to delete.

2. Select the organization to delete. Click on the _Actions_ dropdown.

3. From the _Actions_ dropdown, select _Delete __<Organization Name>__.

4. Click on _Delete <organization name>_ to permanently delete the organization. You will not be able to undo _Delete organization._Click on the Delete button in the warning message, to confirm deletion.

|     |
| --- |
|  |

Before deleting, the _Delete Organization_ operation will check for dependencies that could cause instability in the organization hierarchy. If any such dependencies exist, you will be prompted to resolve those, before continuing to delete the organization. A common dependency that could prevent you from deleting the organization is when an organization in the hierarchy is set up as a _parent_ for [Automatic Applications.](https://help.sonatype.com/en/automatic-application.html "Automatic Applications")

An example of a partially successful _Delete Organization:_

|     |
| --- |
|  |

You can retry deleting the organization after resolving the dependencies.

## Moving an organization

You may move an organization containing dependents to another location in the hierarchy. Configuration on the organization is maintained during the move as it is realigned to inheritance rules of the new location.

Configuration includes: policies, application categories, labels, license threat groups, and waivers. These remain unaffected by the change and will apply to all dependents.

|     |
| --- |
|  |

In the example above, policies, application categories, license threat levels, and waivers for the moving organization continue to apply to its dependents; applications a.1 and a.2.

Organization A now inherits the configuration of _Organization B_ as the child of that organization.

### Move an Organization to a New Parent

1. Navigate to the organization configuration view
2. Select `Move Organization` from the `Actions` menu
3. Choose the name of the new parent organization
4. Select Move

|     |
| --- |
|  |

### Error Handling

When encountering error messages, select `Download CSV` to review the conflicts.

Common conflicts are missing configuration or when duplicate policy elements occur. Configuration inherited from higher in the hierarchy does not result in duplicates. To resolve we recommend setting the duplicate elements to the new parent organization and trying again.

Review that the following elements are configured in both organizations:

```
Application Categories, Labels, License threat groups, Policies
```

|     |
| --- |
|  |

### Warnings

You may encounter warnings when the move operation was successful, but need to review enforcement was set correctly.

| Warning | Resolution |
| --- | --- |
| Inherited license overrides | Reassign the license overrides at the new parent organization |
| Inherited waivers | Review the waivers and reassign them at the new parent organization |
| Inherited continuous monitoring settings | Adjust the settings at the new parent organization to match the previous settings |

## Search results

No results found