Skip to main content
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

1

First-Time Setup

When you sign up, you’ll create your first organization and project.You can also select your data region (EU & US).
2

Add Projects

Create additional projects for different applications.Create additional projects in Metorial

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

​
What’s Next?

Environments Guide

Learn about development vs production instances.

Providers

Manage provider deployments within your projects.