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

# Projects and Organizations

> Organizations and projects help you structure your work in Metorial and manage access to resources.

<Note>
  **What you'll learn:**

  * How organizations and projects are structured
  * How to organize your deployments
</Note>

## Understanding the Hierarchy

Metorial uses a hierarchy to organize your work:

```text theme={null}
Organization
└── Project(s)
    └── Instance(s)
        └── Provider Deployments
        └── API Keys
        └── Provider Auth Configs
```

### Organizations

An **organization** is your top-level workspace - typically representing your company, team, or personal account.

### Projects

A **project** is a container for related work - typically representing an application or product.

### Instances

An **instance** represents an environment within a project (e.g., Development, Production).

## Structuring Your Workspace

<Steps>
  <Step title="Use an organization for the team">
    Keep team-level settings, members, and shared access under the organization.
  </Step>

  <Step title="Add Projects">
    Create projects for different applications, products, or customer environments.

    <img src="https://mintcdn.com/metorial/fydw7J6y9LueIJC4/images/concepts/organization.png?fit=max&auto=format&n=fydw7J6y9LueIJC4&q=85&s=2a6b0468474282d6565186cf2280cb3d" alt="Create additional projects in Metorial" width="3838" height="2046" data-path="images/concepts/organization.png" />
  </Step>
</Steps>

## Using Different API Keys

Projects and Instances are isolated - use different API keys for different projects:

<CodeGroup>
  ```typescript TypeScript theme={null}
  // Project A
  let metorialA = new Metorial({
      apiKey: process.env.METORIAL_PROJECT_A_KEY
  });

  // Project B
  let metorialB = new Metorial({
      apiKey: process.env.METORIAL_PROJECT_B_KEY
  });
  ```

  ```python Python theme={null}
  import os
  from metorial import Metorial

  # Project A
  metorial_a = Metorial(api_key=os.getenv("METORIAL_PROJECT_A_KEY"))

  # Project B
  metorial_b = Metorial(api_key=os.getenv("METORIAL_PROJECT_B_KEY"))
  ```
</CodeGroup>

## What's Next?

<CardGroup cols={2}>
  <Card title="Environments Guide" icon="layers" href="/concepts-environments">
    Learn about development vs production instances.
  </Card>

  <Card title="Providers" icon="server" href="/concepts-providers">
    Manage provider deployments within your projects.
  </Card>
</CardGroup>