Labels

Labels are short alphanumeric tags you assign to a project. Use them to categorize your projects and filter them within an organization, for example by environment (production, staging), team, or region.

Manage in the Console

To manage labels from the Appwrite Console:

1. Navigate to your project.
2. Open the Settings section. The Labels card is on the Overview tab.
3. In the Labels field, type a label and press Enter, or select one of the suggested labels. Labels may contain only alphanumeric characters.
4. Click Update to save your changes.

Manage with a Server SDK

You can also manage project labels programmatically using a Server SDK.

Update labels

The labels array replaces the project's existing labels, so include every label you want to keep in each call. A project can have up to 1000 labels, each up to 36 alphanumeric characters long.

import { Client, Project } from 'node-appwrite';

const client = new Client()
    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
    .setProject('<YOUR_PROJECT_ID>') // Your project ID
    .setKey('<YOUR_API_KEY>'); // Your API key

const project = new Project(client);

const result = await project.updateLabels({
    labels: ['production', 'eu']
});

const result = await project.get();
console.log(result.labels); // ['production', 'eu']

Benefits

• Organize at scale. Group related projects with shared tags such as environment, team, or region, so large organizations stay navigable.
• Faster filtering. Find the projects you need by filtering an organization on its labels instead of scanning the full list.
• Repeatable provisioning. Apply a consistent labeling scheme across projects from a script, keeping your organization tidy without manual Console work.