Platform.sh User Documentation

Organizations

Sign up for Upsun

Get your free trial by clicking the link below.

Get your Upsun free trial

Organizations allow you to manage your Platform.sh projects, users, and billing. You can group multiple projects in one organization and manage them together.

To manage users within your organization, see how to manage organization users.

Manage your organization settings Anchor to this heading

As an organization owner, you can manage the basic settings for your organization such as its name and URL.

  1. Navigate to the organization you want to manage (or a project in it).
  2. Open the user menu (your name or profile picture).
  3. Click Settings.
  4. Click Edit to edit the label or click in the Organization URL field to edit the URL.
  5. Click Save.

To change the name (URL) and label of the acme organization, run:

platform organization:info --org acme label "Acme Corp" name acme-corp

To verify the changes, run:

platform organization:info --org acme-corp

Manage your organization billing Anchor to this heading

As an organization owner or an organization user with the Manage billing permission, you can access and download invoices and edit billing information such as the stored credit card and billing address.

  1. Navigate to the organization you want to manage (or a project in it).
  2. Open the user menu (your name or profile picture).
  3. Click Billing.

Create a new organization Anchor to this heading

When you create a new project, if you don’t already have an organization, one is created for you automatically.

You can create new organizations with different payment methods and billing addresses and organize your projects as you want.

  1. Navigate to your existing organization or a project in it.
  2. Open the user menu (your name or profile picture).
  3. Click Create Organization.
  4. Enter the required information (label, organization URL, company name, country, security contact).
  5. Click Create organization.

To create an organization with the label Acme and the name (URL) acme, run:

platform organization:create --label "Acme" --name acme --country "United States"

To verify the changes, run:

platform organization:info --org acme

Delete an existing organization Anchor to this heading

As an organization owner, you can delete your own organization.

Note that if your organization owns projects or owes remaining invoices, you can not delete it yourself. To have it deleted, contact support.

  1. Navigate to your existing organization or a project in it.
  2. Open the user menu (your name or profile picture).
  3. Click Settings.
  4. Click Delete Organization.
  5. Confirm your decision by clicking Delete.

To delete the organization acme, run:

platform organization:delete --org acme

Transfer project ownership Anchor to this heading

You can transfer your plan ownership to a different organization at anytime. You have to be an organization owner or have the manage plan permission.

  1. Make the new organization owner a project admin for the project you want to transfer.
  2. To ask for the transfer, from your organization account open a support ticket.

Once the transfer is completed, the new organization can administer all project settings and billing and receives future invoices. Ownership transfer automatically transfers subscription charges to the new organization.

Transfer organization ownership Anchor to this heading

To transfer an organization to a different owner, first make sure that user is part of the organization. If they aren’t yet, add them. Then open a support ticket from the current organization to ask for the transfer.

Is this page helpful?