Projects and Workspaces
Learn how to organize your translations using projects and workspaces in Babelize.
Projects and Workspaces
Projects and workspaces help you organize translations, share settings, and collaborate with team members. This guide explains how to use them effectively.
Understanding Projects
A project is a container for related translations that share:
- Source language
- Target languages
- Glossary terms
- Translation history
- Team access permissions
When to Create a New Project
Create separate projects for:
- Different products or applications
- Content with distinct terminology requirements
- Teams that need isolated access
- Projects with different source languages
Project Properties
Each project has the following configurable properties:
| Property | Description | Can Be Changed |
|---|---|---|
| Name | Display name for the project | Yes |
| Description | Optional notes about the project | Yes |
| Source Language | Primary language of your content | No* |
| Target Languages | Languages you translate into | Yes (add only) |
| Glossary | Project-specific terminology | Yes |
*Source language cannot be changed after project creation. Create a new project if you need a different source language.
Creating a Project
- Navigate to Projects in the sidebar
- Click New Project
- Enter a project name
- Write an optional description
- Select your source language
- Select one or more target languages
- Click Create
Managing Target Languages
You can add target languages at any time:
- Open the project
- Go to Settings → Languages
- Click Add Language
- Select from available languages
- Click Save
Removing a target language archives existing translations but does not delete them.
Workspaces (Team Accounts)
Workspaces are available on the Team plan. They provide:
Shared Projects
Projects created in a workspace are accessible to all workspace members based on their role.
Centralized Billing
All usage within a workspace is billed to the workspace account, not individual members.
Role-Based Access
Workspace members have one of these roles:
| Role | Capabilities |
|---|---|
| Owner | Full access, billing, member management |
| Admin | Project management, member invites |
| Editor | Create and run translations |
| Viewer | Read-only access to translations |
Creating a Workspace
- Go to Settings → Workspace
- Click Create Workspace
- Enter a workspace name
- Choose a plan (Team)
- Complete billing setup
Inviting Team Members
Workspace owners and admins can invite members:
- Go to Settings → Team
- Click Invite Member
- Enter the email address
- Select a role
- Click Send Invite
Invitees receive an email with a link to join the workspace.
Project Templates
Save time by creating projects from templates:
- Open an existing project
- Go to Settings → Save as Template
- Name your template
- New projects can be created from this template
Templates preserve:
- Language configuration
- Glossary terms
- Default settings
Templates do not copy:
- Translation history
- Uploaded files
- Team members
Duplicate Projects and Replacing
Handling Duplicate Repository URLs
When you try to create a project with a repository URL that already exists in your account, Babelize provides two options:
- Go to Existing Project - Opens the existing project that uses this repository
- Replace Existing Project - Creates a new project and soft-deletes the old one
When to Use Replace
The Replace option is useful when:
- You want to start fresh with new language configurations
- The previous project had incorrect settings
- You need to reset the translation history
- You're starting a major refactoring of your codebase
What Happens During Replace
When you choose "Replace existing project":
- The old project is soft-deleted (moved to archive)
- A new project is created with your new settings
- All translation history from the old project is preserved in the archive
- You can restore the old project within 30 days from the Archive
Replacing a project does not consume additional credits for previously translated strings. The Translation Memory is shared across your account.
Restoring a Replaced Project
If you need to access the old project's data:
- Navigate to Projects → Archive
- Find the replaced project (marked with replacement date)
- Click Restore
Note: You cannot have two active projects with the same repository URL. Restoring will prompt you to archive or delete the current project first.
Archiving vs. Deleting
Archive
- Removes from active project list
- Preserves all data
- Can be restored anytime
- Stops billing for storage after 90 days
Delete
- Permanently removes all data
- Cannot be undone
- Requires typing project name to confirm
- Immediate effect
Best Practices
Naming Conventions
Use consistent, descriptive names:
- ✓
mobile-app-ios - ✓
marketing-website-2024 - ✗
project1 - ✗
test
Glossary Organization
Maintain glossaries at the project level for product-specific terms. For company-wide terms, use a shared glossary (Team feature).
Access Control
Apply the principle of least privilege. Give team members the minimum role required for their work.