{"__v":0,"_id":"589cc675ae20562300460ce8","category":{"project":"568fde81b700ce0d002f4b43","version":"56954a94fe18811700c9bfda","_id":"589cc675ea37da23004e05e1","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-02-09T19:43:49.598Z","from_sync":false,"order":3,"slug":"dashboard","title":"Dashboard"},"parentDoc":null,"project":"568fde81b700ce0d002f4b43","user":"568fffce769f210d0013258f","version":{"__v":6,"_id":"56954a94fe18811700c9bfda","project":"568fde81b700ce0d002f4b43","createdAt":"2016-01-12T18:48:52.007Z","releaseDate":"2016-01-12T18:48:52.007Z","categories":["56954a95fe18811700c9bfdb","56954a95fe18811700c9bfdc","56954a95fe18811700c9bfdd","56954a95fe18811700c9bfde","56954a95fe18811700c9bfdf","56954a95fe18811700c9bfe0","56954a95fe18811700c9bfe1","56954a95fe18811700c9bfe2","56954a95fe18811700c9bfe3","56954a95fe18811700c9bfe4","5695649fdcaf0d1700cb8721","5696c1168560a60d00e2c1d6","56a7a32e79395317007c1ad6","5898fc3eec49fb0f004c2663","589cc675ea37da23004e05e1"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"foo","version_clean":"0.0.0","version":"0.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-02-09T19:43:49.779Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"# Contents\n\n- :fa-angle-right: [What are Organizations?](#section-what-are-organizations-)\n  - [Personal Organization](#section-personal-organization)\n- :fa-angle-right: [Creating an Organization](#section-creating-an-organization)\n  - [Inviting Users](#section-inviting-users)\n  - [User Roles](#section-user-roles)\n  - [User Requests](#section-user-requests)\n  - [Transferring Projects](#section-transferring-projects)\n- :fa-angle-right: [Deleting an Organization](#section-deleting-an-organization)\n\n***\n\n# What are Organizations?\n\nOrganizations are used to group projects and to manage permissions for who can access those projects.\n\n![Organizations](https://cloud.githubusercontent.com/assets/1271364/22709686/a81ed568-ed48-11e6-8ebd-55c014682815.png)\n\nWith organizations you can:\n\n- Create projects\n- Invite users\n\nOnce out of beta, organizations will also handle billing.\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Cypress Organizations are meant to work similar to GitHub Organizations.\"\n}\n[/block]\n\n***\n\n## Personal Organization\n\nBy default, every user of Cypress is given a personal organization - named after you.\n\nYou cannot delete or edit the name of this organization.\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"All existing Cypress projects prior to version 0.19.0 were automatically added to your personal organization.\"\n}\n[/block]\n\n***\n\n# Creating an Organization\n\n![Add Organization dialog](https://cloud.githubusercontent.com/assets/1271364/22709492/f1d3e7e4-ed47-11e6-8f35-64fed633862b.png)\n\n***\n\n## Inviting Users\n\nYou can invite users to Cypress from our [Dashboard](https://on.cypress.io/dashboard). Invited users will see the projects and runs for your organization.\n\nEven though we are in a **private beta**, any user you invite will automatically be whitelisted to use Cypress. This means you can freely invite your team members without needing to talk to us!\n\n*To invite a user to an organization:*\n\n1. Click the :fa-cog: beside the Projects you want to give the user access to.\n2. Click 'Invite User'. Note: you must have the role of 'owner' or 'admin' to invite users.\n3. Fill in the email and select the role for the user and click 'Invite User' Note: only 'owner's can give other user's 'owner' access.\n4. The user will recieve an invite email with a link to accept the invitation.\n\n![Invite User dialog](https://cloud.githubusercontent.com/assets/1271364/22709421/baf79a54-ed47-11e6-9796-79ba2008d2d2.png)\n\n***\n\n## User Roles\n\nUser's can be assigned roles that affect their access to certain features.\n\n- **Member:** Can see the projects, runs, and keys.\n- **Admin:** Can also invite, edit and delete users.\n- **Owner:** Can also transfer or delete projects. Can delete and edit the organization.\n\n***\n\n## User Requests\n\nWe have also built Cypress with the ability for users to \"Request\" access to a given organization. This makes for a very natural flow.\n\nIf a developer on your team has access to Cypress and your project's source code - they can request to be given access to your Organization.\n\nThis means instead of you having to invite team members up front, they can simply request access and you can choose to accept or deny them.\n\n![User requesting access](https://cloud.githubusercontent.com/assets/1271364/22709877/61ca46be-ed49-11e6-80cc-d54299634053.png)\n\n***\n\n## Transferring Projects\n\nYou can transfer projects that you own to another organization or another user.\n\nThis functionality only exists in our [Dashboard](https://on.cypress.io/dashboard).\n\n![Transfer Project dialog](https://cloud.githubusercontent.com/assets/1271364/22708695/440f4e5c-ed45-11e6-9a98-8f91b67871a3.png)\n\n\n***\n\n# Deleting an Organization\n\nYou can delete organizations that you own as long as they don't have any projects. You must first transfer ownership of your projects to another organization before you can delete them.\n\n![Delete Organization](https://cloud.githubusercontent.com/assets/1271364/22709764/f9c63e9c-ed48-11e6-885d-ced14d91c3a8.png)","excerpt":"Manage your Organizations","slug":"organizations","type":"basic","title":"Organizations"}

Organizations

Manage your Organizations

# Contents - :fa-angle-right: [What are Organizations?](#section-what-are-organizations-) - [Personal Organization](#section-personal-organization) - :fa-angle-right: [Creating an Organization](#section-creating-an-organization) - [Inviting Users](#section-inviting-users) - [User Roles](#section-user-roles) - [User Requests](#section-user-requests) - [Transferring Projects](#section-transferring-projects) - :fa-angle-right: [Deleting an Organization](#section-deleting-an-organization) *** # What are Organizations? Organizations are used to group projects and to manage permissions for who can access those projects. ![Organizations](https://cloud.githubusercontent.com/assets/1271364/22709686/a81ed568-ed48-11e6-8ebd-55c014682815.png) With organizations you can: - Create projects - Invite users Once out of beta, organizations will also handle billing. [block:callout] { "type": "info", "body": "Cypress Organizations are meant to work similar to GitHub Organizations." } [/block] *** ## Personal Organization By default, every user of Cypress is given a personal organization - named after you. You cannot delete or edit the name of this organization. [block:callout] { "type": "info", "body": "All existing Cypress projects prior to version 0.19.0 were automatically added to your personal organization." } [/block] *** # Creating an Organization ![Add Organization dialog](https://cloud.githubusercontent.com/assets/1271364/22709492/f1d3e7e4-ed47-11e6-8f35-64fed633862b.png) *** ## Inviting Users You can invite users to Cypress from our [Dashboard](https://on.cypress.io/dashboard). Invited users will see the projects and runs for your organization. Even though we are in a **private beta**, any user you invite will automatically be whitelisted to use Cypress. This means you can freely invite your team members without needing to talk to us! *To invite a user to an organization:* 1. Click the :fa-cog: beside the Projects you want to give the user access to. 2. Click 'Invite User'. Note: you must have the role of 'owner' or 'admin' to invite users. 3. Fill in the email and select the role for the user and click 'Invite User' Note: only 'owner's can give other user's 'owner' access. 4. The user will recieve an invite email with a link to accept the invitation. ![Invite User dialog](https://cloud.githubusercontent.com/assets/1271364/22709421/baf79a54-ed47-11e6-9796-79ba2008d2d2.png) *** ## User Roles User's can be assigned roles that affect their access to certain features. - **Member:** Can see the projects, runs, and keys. - **Admin:** Can also invite, edit and delete users. - **Owner:** Can also transfer or delete projects. Can delete and edit the organization. *** ## User Requests We have also built Cypress with the ability for users to "Request" access to a given organization. This makes for a very natural flow. If a developer on your team has access to Cypress and your project's source code - they can request to be given access to your Organization. This means instead of you having to invite team members up front, they can simply request access and you can choose to accept or deny them. ![User requesting access](https://cloud.githubusercontent.com/assets/1271364/22709877/61ca46be-ed49-11e6-80cc-d54299634053.png) *** ## Transferring Projects You can transfer projects that you own to another organization or another user. This functionality only exists in our [Dashboard](https://on.cypress.io/dashboard). ![Transfer Project dialog](https://cloud.githubusercontent.com/assets/1271364/22708695/440f4e5c-ed45-11e6-9a98-8f91b67871a3.png) *** # Deleting an Organization You can delete organizations that you own as long as they don't have any projects. You must first transfer ownership of your projects to another organization before you can delete them. ![Delete Organization](https://cloud.githubusercontent.com/assets/1271364/22709764/f9c63e9c-ed48-11e6-885d-ced14d91c3a8.png)