Working with Projects
Learn how to organize translations using projects.
Working with Projects
Projects help you organize translations by application, feature, or team. Each project can have its own settings and glossaries.
What are Projects?
Projects provide:
- Organization - Group related translations together
- Analytics - Track usage per project
- Glossaries - Apply project-specific terminology
- Filtering - View translation history by project
Creating a Project
- Navigate to your Dashboard
- Click Create Project
- Enter a project name and optional description
- Click Create
Using Projects in API Calls
Include the project_slug parameter to associate translations with a project (add workspace when the operator token can access more than one workspace):
curl -X POST https://your-domain.com/api/v1/translate \
-H "Authorization: Bearer opt_your-token" \
-H "Content-Type: application/json" \
-d '{
"text": "Welcome to our app",
"target_lang": "es",
"workspace": "my-workspace",
"project_slug": "marketing"
}'Benefits of Using Projects
1. Usage Tracking
View character consumption broken down by project in your dashboard. This helps you:
- Identify high-usage features
- Allocate costs to teams
- Plan capacity needs
2. Glossary Integration
Projects can be linked to glossaries, automatically applying your terminology rules:
- Create a glossary with your terms
- Associate the glossary with your project
- Include
project_slugin API calls
3. Translation History
Filter your translation history by project to:
- Review past translations
- Debug issues
- Export project-specific data
Project Organization Tips
Tip: Create projects that match your application structure - one per microservice, feature, or team.
Example Project Structure
| Project | Purpose |
|---|---|
mobile-app | iOS and Android app strings |
web-dashboard | Web application UI |
marketing-site | Public website content |
email-templates | Transactional emails |
api-responses | API error messages |
Managing Projects
Editing a Project
- Click on the project in your dashboard
- Click Settings
- Update the name or description
- Save changes
Deleting a Project
Warning: Deleting a project does not delete translation history, but the logs will no longer be associated with a project.
- Open project settings
- Scroll to the danger zone
- Click Delete Project
- Confirm deletion