Organizations

In this guide, you'll learn about organizations in Cloud and how to manage them.

What is an Organization?#

In Cloud, an organization is a group of users that have access to the same settings, projects, resources, environments, and billing details.

As a user, you must be in an organization to create and deploy projects. A user can be a member of multiple organizations.

You can create a new organization when you sign up for Cloud. This will make you the organization's owner.

You can also join an existing organization by receiving an invite from a user in that organization.


Organization Dashboard#

When you open the Cloud dashboard and log in, you're viewing the projects, resources, and settings of a specific organization. You'll find the name of that organization at the top left of the dashboard.

The Cloud dashboard with the organization name at the top left

Switch Organization#

If you're a member of multiple organizations, you can switch between them to view their projects, resources, and settings.

To switch to a different organization:

  1. Click on the organization name at the top left of the Cloud dashboard.
  2. Choose the organization you want to switch to from the dropdown.

This will change the view to the selected organization, and you'll see its projects, resources, and settings.

Organization switcher at the top left of the Cloud dashboard


View Organization Settings#

To view an organization's settings:

  1. If you're in a different organization, switch to the organization whose settings you want to view.
  2. Click on the organization switcher at the top left of the Cloud dashboard.
  3. Choose "Organization Settings" from the dropdown.

This will open a new window where you can view and manage an organization's settings.

Window showing the organization settings


Edit Organization Details#

To edit an organization's general details:

  1. Open the organization's settings.
  2. In the General tab, you can edit the organization's name and billing email address.
  3. Once you're done making changes, click the "Save changes" button in the Details section.

Window showing the organization settings with the General tab selected and the Details section highlighted


Leave Organization#

Warning: Leaving an organization will remove you from it, and you'll no longer have access to its projects, resources, and settings. You can only access it by being invited again by another user in the organization.

To leave an organization:

  1. Open the organization's settings.
  2. In the General tab, find the "Leave organization" section.
  3. Click the "Leave organization" button.

Window showing the organization settings with the General tab selected and the Leave organization section highlighted


Delete Organization#

Danger: Deleting an organization will remove all its projects, resources, and settings. This action is irreversible, and you won't be able to recover any data after deletion.

To delete an organization:

  1. Open the organization's settings.
  2. In the General tab, find the "Delete organization" section.
  3. Click the "Delete organization" button.

Window showing the organization settings with the General tab selected and the Delete organization section highlighted


View Organization Members#

To view the members of an organization:

  1. Open the organization's settings.
  2. Click on the "Team" tab.

In this window, you can view the members of the organization, their roles, and their email addresses. You can also view invited members who haven't accepted the invitation yet.

Window showing the organization members in the Team tab

View Available Seats#

Based on your organization's plan, you may have a limited number of seats available for members. You can view the number of available seats at the top of the Team tab.

If you need more seats, you can contact our sales team to add more seats to your organization or upgrade your plan.

Window showing the organization members in the Team tab with the available seats highlighted

Invite Members to Organization#

Note: Make sure you have enough available seats in your organization before inviting new members.

To invite members to your organization:

  1. Open the organization's settings.
  2. Click on the "Team" tab.
  3. In the "Invite members" section, enter the email address of the user you want to invite, then click the button. You can enter multiple email addresses.
  4. Once you're done, click the "Invite all" button.

These users will receive an email invitation to join your organization. They can accept the invitation by clicking the link in the email.

Window showing the organization members in the Team tab with the Invite members section highlighted

Resend Invitation#

You may need to resend an invitation if a user has lost the invitation email or if the invitation has expired.

To resend an invitation:

  1. Open the organization's settings.
  2. Click on the "Team" tab.
  3. In the "Invited members" section, find the user whose invitation you want to resend.
  4. Click the button at the end of the user's row.
  5. Choose "Resend invite" from the dropdown.

Window showing the organization members in the Team tab with the dropdown of an invited member opened

Revoke Invitation#

You can revoke an invitation to a user if you no longer want them to join your organization.

To revoke an invitation:

  1. Open the organization's settings.
  2. Click on the "Team" tab.
  3. In the "Invited members" section, find the user whose invitation you want to revoke.
  4. Click the button at the end of the user's row.
  5. Choose "Revoke invite" from the dropdown.

Window showing the organization members in the Team tab with the dropdown of an invited member opened

Remove Members from Organization#

Owner and admin users can remove any members from the organization that aren't owners.

To remove a member from your organization:

  1. Open the organization's settings.
  2. Click on the "Team" tab.
  3. In the "Organization members" section, find the member you want to remove.
  4. Click the button at the end of the member's row.
  5. Choose "Remove from organization" from the dropdown.

Window showing the organization members in the Team tab with the dropdown of a member opened


Manage Profile Details#

To edit your profile's details:

  1. Click on your name and avatar at the top right of the Cloud dashboard.
  2. Choose "Settings" from the dropdown.
  3. In the Profile Settings page, you can edit your name, email address, and your membership in organizations.

Window showing the profile settings with the Profile tab selected


Manage Billing Details#

Refer to the Billing & Usage guide to learn how to manage your organization's billing details, including payment methods, invoices, and usage.

Was this guide helpful?
Ask Anything
FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break