> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sevalla.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These are the docs for Sevalla, a platform for deploying applications, databases, static sites, object storage and load balancers. The dashboard is at https://app.sevalla.com.
> Bold text in steps is an exact dashboard label.
> To act on a Sevalla account, prefer the Sevalla MCP server (https://mcp.sevalla.com/mcp, see https://docs.sevalla.com/ai-agents/overview.md), then the Sevalla CLI (https://docs.sevalla.com/developer-tools/cli.md), then the REST API (https://api-docs.sevalla.com, OpenAPI spec at https://api.sevalla.com/v3/openapi.json).
> Every page index is at https://docs.sevalla.com/llms.txt.

# Companies

> Understand what a company owns in Sevalla, then switch between companies, create a company, rename it, or delete it and cancel its subscription.

A company is the account that owns your services, your people and your billing in Sevalla. Every application, database, static site, bucket, load balancer, pipeline and project belongs to exactly one company, and each company has its own payment method, invoices and users.

## How companies work

* **One company per service.** A service belongs to the company it was created in and can't be shared with another company.
* **Many companies per person.** Your user account (your sign-in) can belong to any number of companies, with a different role in each. You switch between them in the sidebar.
* **One owner per company.** The person who creates a company is its company owner. Ownership moves only by [transferring it](/company/users-and-roles#transfer-ownership) to a company admin.
* **Separate billing.** Each company has its own payment method, billing details, credits and invoices. See [How billing works](/billing/overview).
* **Up to 10 companies.** You can own up to 10 companies. Companies you're invited to don't count toward this limit.

What belongs to the company and what belongs to you:

| Belongs to the company | Belongs to your user account |
| - | - |
| Services, projects and pipelines | Name, email address and password |
| Users and their roles ([Users and roles](/company/users-and-roles)) | Two-factor authentication ([Sign in and two-factor authentication](/account/sign-in)) |
| Billing, invoices and usage | Git sign-in and Git repository access ([My account](/account/overview)) |
| API keys, webhooks, global variables and registry credentials | Email notification settings |
| Single sign-on ([Single sign-on](/company/single-sign-on/overview)) | |

## Switch companies

The company switcher at the top of the sidebar shows the company you're in. Click it to see your companies and the projects of the current company, then click a company (or a project) to open it. Type in **Search companies and projects…** to filter a long list.

When you switch from a service's page, Sevalla opens the new company's **Home**, because services belong to one company. When you switch from a section such as **Billing** or **Usage**, you stay in that section.

## Create a company

Anyone with a Sevalla account can create a company and becomes its company owner.

<Steps>
  <Step title="Open the company switcher">
    At the top of the sidebar, click the company name, then click **Create company**.
  </Step>

  <Step title="Name the company">
    In **Name**, enter the company name (for example, `Acme Inc`), then click **Create company**. You can update the name later.
  </Step>

  <Step title="Add billing details and a payment method">
    Sevalla opens the new company on **Last step before using Sevalla**. Enter the card and the billing details, then click **Complete setup**. See [Add your first payment method](/billing/payments#add-your-first-payment-method).
  </Step>
</Steps>

<Frame>
  <img className="block dark:hidden" src="https://assets.sevalla.com/screenshots/light/company-switcher-create.png" alt="The company switcher listing Acme Inc with its projects and Globex, with Update company name and Create company at the bottom" width="322" />

  <img className="hidden dark:block" src="https://assets.sevalla.com/screenshots/dark/company-switcher-create.png" alt="The company switcher listing Acme Inc with its projects and Globex, with Update company name and Create company at the bottom" width="322" />
</Frame>

Until a company has billing details and a payment method, its pages show the setup form instead of their content. **Billing** and **My account** stay available. People in the company who can't update billing see **Payment method required** or **Billing details required**, which asks them to contact the company owner, an admin or a billing user. For details on payment methods, see [Payment methods and invoices](/billing/payments).

The company name accepts letters, numbers, punctuation and spaces in any script. Emoji and symbols are rejected with `Company name contains non-alphanumeric unicode characters`.

If you aren't part of any company (for example, after you delete your last one), Sevalla shows a **Create your company** page when you sign in. To join an existing team instead, ask an owner or admin of that company to [invite you](/company/users-and-roles#invite-users).

## Rename a company

<Info>
  Only company owners and admins can update the company name.
</Info>

<Steps>
  <Step title="Open the company switcher">
    At the top of the sidebar, click the company name, then click **Update company name**.
  </Step>

  <Step title="Enter the new name">
    In **Name**, enter the new name, then click **Update company name**.
  </Step>
</Steps>

The name changes everywhere in the dashboard. It doesn't change your invoices: invoices and other billing documents use the name in your billing details. To change that name, click **Update billing settings** in the same sheet, which opens the billing portal. See [Payment methods and invoices](/billing/payments).

<Frame>
  <img className="block dark:hidden" src="https://assets.sevalla.com/screenshots/light/company-update-name.png" alt="The Update company name sheet with a Name field, an Only shown in the dashboard notice and an Update billing settings button" width="448" />

  <img className="hidden dark:block" src="https://assets.sevalla.com/screenshots/dark/company-update-name.png" alt="The Update company name sheet with a Name field, an Only shown in the dashboard notice and an Update billing settings button" width="448" />
</Frame>

## Delete a company

Deleting a company cancels its Sevalla subscription, settles its final balance and deletes the company right away. Only the company owner can delete a company, from the **Billing** page.

<Warning>
  Deleting a company is immediate and can't be undone. Everyone in the company loses access to it.
</Warning>

### Before you delete a company

* **Delete every project and service first.** Sevalla refuses to delete a company that still has projects, applications, databases, static sites, object storage buckets, load balancers or pipelines. The delete sheet lists what's left, with a count for each type. Each product's settings page explains how to delete it, for example [delete an application](/applications/settings).
* **Settle unpaid invoices.** A suspended company can't be deleted: the attempt fails with `The service is suspended.` See [Failed payments](/billing/failed-payments).
* **Keep the company instead, if someone else will run it.** [Transfer ownership](/company/users-and-roles#transfer-ownership) to a company admin, and they can keep using it.

### Delete the company

<Steps>
  <Step title="Open the danger zone">
    In the sidebar, under **Company**, click **Billing**. At the bottom of the page, in **Danger zone**, click **Delete company**.
  </Step>

  <Step title="Say why you're leaving">
    Under **Why are you leaving?**, pick a reason: **Too expensive**, **Missing features**, **Stability or reliability issues**, **Switching to another provider**, **Project ended / no longer needed** or **Other** (which asks you to tell more). Optionally add feedback, then click **Continue**.
  </Step>

  <Step title="Review and confirm">
    Read what happens. If this is your only company, you can select **Also delete my user account** (see [Delete your account](/account/delete)). Type the company name to confirm, then click **Delete company**.
  </Step>
</Steps>

If you belong to other companies, Sevalla switches you to one of them and shows `Company deleted. Switched to <company>.` If it was your last company, Sevalla signs you out.

### What happens when you delete a company

* **Your subscription ends and the final balance is settled immediately.** Unbilled usage goes on a final invoice. A final invoice over $1 is charged to your payment method; $1 or less is forgiven. Unused credits are removed.
* **The company and its data are deleted.** Its users lose access, and its single sign-on settings are removed.
* **Your user account stays**, unless you selected **Also delete my user account**.

If the final invoice can't be charged, the company isn't deleted and you see `Your final invoice could not be charged. Settle your outstanding balance and try again to cancel.` Update your [payment method](/billing/payments), then try again.

### Companies shared with MyKinsta

A company can also be used in MyKinsta, Kinsta's WordPress hosting dashboard. If the company has a WordPress hosting plan or WordPress sites there, deleting it from Sevalla only cancels the Sevalla subscription and settles the Sevalla balance. The company, your user account and everything in MyKinsta stay, and Sevalla shows `Sevalla subscription cancelled.` after it reloads.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.