# Organizations ## Overview Organizations are the root object in the hierarchy of the Digital Spine IAM solution. They are administrators that govern the creation and management of [Applications ](https://docs-launchpad.energyweb.org/energy-solutions/digital-spine-by-energy-web/component-guides/self-sovereign-identities/technical-guide/applications)and [Roles](https://docs-launchpad.energyweb.org/energy-solutions/digital-spine-by-energy-web/component-guides/self-sovereign-identities/technical-guide/roles-and-iam), and by extension Topics and Channels - all of these objects are nested under the Organization object. Organizations are identified by a namespace using the pattern `organization.iam.ewc`. ### Hierarchy Diagram (placeholder)

*** ## User Guide ### Pre-requisites * User logged into Switchboard #### Create an Organization {% hint style="info" %} The “Create Organization” button allows creating only one organization per a wallet. After using, the button is hidden from UI. {% endhint %} 1. In the home page, click on the `Governance` menu

2. Click on `Create Organization` button

3. Fill in the form and submit the request

#### Modify an Organization 1. In the Organization Management page, click on the action button right next to the organization that you want to edit

2. Update organization and scroll down to click `Next` and confirm your changes

3. Confirm the details and click `Next`

4. Organization updated #### Remove an Organization 1. In the Organization Management page, click on the action button right next to the organization that you want to delete

*** #### Organization options Assume that you already own an organization, on the Organization management tab you can perform several options related to your organization and its EWNS namespace, each using the options under the three vertical dots button (next to an organization namespace in the list).

Symbol	Name	Description
Symbol	Name	Description
	View Details	View the basic details of your organization, including the logo, namespace, organization name, website, description, and other data.
	Create Sub-Organization	Create a new sub-organization owned by the organization. This allows you to define applications and roles for specific subsidiaries or business units within your organizational umbrella. For example, you might create “subsidiary1.exampleco.iam.ewc” and “subsidiary2.exampleco.iam.ewc” so that you can define applications and roles specific to those subsidiaries (as described in the following sections of this document).
	View Applications	View the applications owned by this organization (i.e., go to application management tab).
	View Roles	View the roles associated with this organization or with any application owned by this organization (i.e., go to role governance tab). Note that that are two kinds of roles: Roles associated with an organization - these roles are independent of any particular application. For example, you might create the role “global dApp admin” to manage all of your organization’s applications. Roles associated with an application - these roles are specific to a particular application. For example, you might create the role “installer” or “renewable energy buyer” in an application that you own. These roles are not necessarily part of your organization.
	Create Application	Create a new application owned by the organization.
	Create Role	Create a new role associated with either this organization or a specific application owned by this organization.
	Edit	Change the details of your organization. Please note that it is not possible to change the root namespace of an organization. For example, after you have defined “`exampleco.iam.ewc`" as your namespace, you could define subdomains (e.g., "`roles.exampleco.iam.ewc`" or "`applications.exampleco.iam.ewc`"), or you could define a new root namespace (e.g., "`exampleorg.iam.ewc`"), but you are not able to change the root namespace "`exampleco.iam.ewc`" into something different. The “others (JSON)” field allows you to specify formatting-related details (e.g., color scheme) that should be applied, so that when you integrate the system into your decentralized applications the branding is consistent. For example, you could add into this field the text: `{"bgcolor":"CDD3FF","txtcolor":"FF0000"}` The above text will set the background color for the system in your application to be the light blue color with hex code `CDD3FF` and the text color to be red with hex code `FF0000`. You can experiment with different formatting options.
	Transfer Ownership	Transfer ownership of your organization and its root namespace to another address.
	Delete	Delete your organization.