<commit_before>---
title: Organization Accounts
layout: page
tags:
  - administration
  - project
  - organizations
  - team management
categories:
  - administration
---

Organizations simplify and enhance team management as well as subscription management for (larger) teams on Codeship.

You can define arbitrary teams, add Codeship accounts to those teams and simply add the team to any organization project. You can now also define read-only access for a specific team to your projects.

* include a table of contents
{:toc}

We currently offer the following roles (though more roles are already on our todo list):

* **Owners** have control over all aspects of an organization. From changing the subscription to managing organization projects and teams.
* **Managers** have control over team and project management of organization. They can add and remove projects and manage the organization teams by adding new team members or assigning projects to teams. They have access to all project and are able to change the project configuration
* **Contributors** have read-only access to their projects. This means that they can view the project dashboard and build details but are not allowed to change project settings or open debug builds.

## Creating an Organization

* Click on your name in the navigation bar at the top and click the green _Create Organization_ button.
* Choose an available name and you're done!

![Creating an Organization]({{ site.baseurl }}/images/administration/create_organization.png)

## Managing Teams

On the _Teams_ tab of the organization settings, you can manage your different teams, add new teams and add or remove team members from the available teams.

Two teams are created for each organization by default:
* _Owners_, containing only the user who created the organization by default. You can however add any other Codeship account to the _Owners_ team as well.
* _Managers_, containing nobody by default.

If you want to create a new team, click the _Create new team_ button and select the appropriate role.

![Creating a Team]({{ site.baseurl }}/images/administration/create_team.png)

Once you have created a new team, you can add new team members via their email address as well as any already existing projects.

If you need to change the team settings (e.g. the name or the role), hover over the team card and click the gear icon showing on the right hand side.

## Adding projects

You can either add a project via the _Select project_ dropdown at the top, or via the _Create a new project_ button in the organizations project settings. Please make sure the correct account (either organization or your private account) is selected first, as it's currently not possible to transfer projects to another account.

Once the project is created you can add it to any of your teams . Members of the _Owners_ and _Managers_ team will have access to all projects by default.

![Adding a project to a team]({{ site.baseurl }}/images/administration/add_project_to_team.png)<commit_msg>Typos and remarks mentioned by @mcgaffin<commit_after>---
title: Organization Accounts
layout: page
tags:
  - administration
  - project
  - organizations
  - team management
categories:
  - administration
---

Organizations simplify and enhance team management as well as subscription management for (larger) teams on Codeship.

You can define arbitrary teams and add them to any organization project and add Codeship accounts to those teams. You can also provide read-only access to some of your team members.

* include a table of contents
{:toc}

We currently offer the following roles (though more roles are already on our todo list):

* **Owners** have control over all aspects of an organization. From changing the subscription to managing organization projects and teams.
* **Managers** have control over team and project management of an organization. They can add and remove projects and manage the organization teams by adding new team members or assigning projects to teams. They have access to all projects and are able to change the project configuration.
* **Contributors** have read-only access to their projects. This means that they can view the project dashboard and build details but are not allowed to change project settings or open debug builds.

## Creating an Organization

* Click on your name in the navigation bar at the top and click the green _Create Organization_ button.
* Choose an available name and you're done!

![Creating an Organization]({{ site.baseurl }}/images/administration/create_organization.png)

## Managing Teams

On the _Teams_ tab of the organization settings, you can manage your different teams, add new teams and add or remove team members from the available teams.

Two teams are created for each organization by default:
* _Owners_, containing only the user who created the organization by default. You can however add any other Codeship account to the _Owners_ team as well.
* _Managers_, containing nobody by default.

If you want to create a new team, click the _Create new team_ button and select the appropriate role.

![Creating a Team]({{ site.baseurl }}/images/administration/create_team.png)

Once you have created a new team, you can add new team members via their email address as well as any existing projects.

If you need to change the team settings (e.g., the name or the role), hover over the team card and click the gear icon showing on the right hand side.

## Adding projects

You can either add a project via the _Select project_ dropdown at the top, or via the _Create a new project_ button in the organization's project settings. Please make sure the correct account (either organization or your private account) is selected first, as it's currently not possible to transfer projects to another account.

Once the project is created, you can add it to any of your teams. Members of the _Owners_ and _Managers_ team will have access to all projects by default.

![Adding a project to a team]({{ site.baseurl }}/images/administration/add_project_to_team.png)
{'fraction_non_alphanumeric': 0.0458821587720746, 'fraction_numerical': 0.0, 'mean_word_length': 4.514103730664241, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6031034', 'n_tokens_mistral': 1433, 'n_tokens_neox': 1384, 'n_words': 903}