concepts-projects-organizations.mdx

title	Projects and Organizations
description	Organizations and projects help you structure your work in Metorial and manage access to resources.

**What you'll learn:**

• How organizations and projects are structured
• How to organize your deployments

Understanding the Hierarchy

Metorial uses a hierarchy to organize your work:

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).

Creating Your Workspace

When you sign up, you'll create your first organization and project.

You can also select your data region (EU & US).

Create additional projects for different applications.

![Create additional projects in Metorial](/images/concepts/organization.png)

Using Different API Keys

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

// 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
});

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"))

What's Next?

Learn about development vs production instances. Manage provider deployments within your projects.