---
title: "Create a project"
description: "Create the organization and project that own manifests, languages, catalogs, and releases."
canonical_url: "https://docs.linguana.dev/docs/use-linguana/create-project"
markdown_url: "https://docs.linguana.dev/docs/use-linguana/create-project.md"
x_farming_labs_generated_preamble: true
agent:
  task: "Create a Linguana organization and project through the customer dashboard."
  outcome: "The project exposes development, staging, and production environments."
  prerequisites:
    - "A Linguana dashboard is running and the user is signed in."
    - "The user can manage the organization."
  sideEffects:
    - "Creates organization and project records."
  verification:
    - "The project appears in the workspace selector and Languages shows English as source."
  rollback:
    - "Use the owner-only staged project deletion control if the project was created by mistake."
  failureModes:
    - symptom: "The New project action is unavailable."
      resolution: "Confirm the signed-in user has Owner or Admin organization permission."
---

# Create a project
URL: /docs/use-linguana/create-project
LLM index: /llms.txt
Description: Create the organization and project that own manifests, languages, catalogs, and releases.
Related: /docs/use-linguana/tokens-and-environments

<!-- farming-labs:agent-contract:start -->
## Agent Contract

Task: Create a Linguana organization and project through the customer dashboard.
Outcome: The project exposes development, staging, and production environments.

### Prerequisites

- A Linguana dashboard is running and the user is signed in.
- The user can manage the organization.

### Side Effects

- Creates organization and project records.

### Verification

- The project appears in the workspace selector and Languages shows English as source.

### Rollback

- Use the owner-only staged project deletion control if the project was created by mistake.

### Failure Modes

- The New project action is unavailable. — Recovery: Confirm the signed-in user has Owner or Admin organization permission.
<!-- farming-labs:agent-contract:end -->

# Create a project

**Audience:** organization owners and admins. **Outcome:** a project with development, staging, and production environments.

## Prerequisites

- A running or hosted Linguana dashboard.
- A signed-in account.
- Permission to create an organization and project.

## Steps

1. Open **Projects** in the dashboard.
2. If the workspace has no organization, choose **Create organization**, enter a name, and save it.
3. Choose **New project**.
4. Enter the application name. The current dashboard creates it with English (`en`) as the source locale.
5. Expand the project to inspect its environments and release policies.

Projects isolate manifests, languages, glossaries, catalogs, and tokens. Environments isolate credentials and release behavior. Do not reuse a production token for development builds.

<ExpectedResult>
The project appears in the workspace selector and exposes development, staging, and production environments. Its ID is the `projectId` used by the compiler and runtime.
</ExpectedResult>

## Verify

Open **Languages** and confirm English is the source language. Open **Tokens** and confirm no secret exists until an owner or admin creates one.

<FailureGuide symptom="Create project is unavailable" cause="Your organization role cannot manage projects." check="Confirm you are an Owner or Admin in Team settings." />

## Next

Create [environment-scoped tokens](/docs/use-linguana/tokens-and-environments), then [connect hosted translations](/docs/getting-started/connect-your-app).

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).