Enable users to request translations

Stay organized with collections Save and categorize content based on your preferences.

To follow step-by-step guidance for this task directly in the Google Cloud console, click Guide me:

Guide me

To enable translations, use the Google Cloud console to create a portal and add users. After you assign users to a portal, they can sign in to the portal and start translating documents.

Before you begin

Set up a project with billing and the Cloud Translation API enabled. Use that project for the following tasks.

Also, decide on which portal tier your users require: basic or advanced. Advanced-tier portals offer additional features at a different translation cost per page. When you create a portal, you select its tier, which cannot be changed later. You can create a portal in each tier if your users require both tiers.

Create a portal

Use the Google Cloud console to create translation portals for your users. A portal is the user interface where authorized users sign in and request translations.

You might create multiple portals to manage different sets of users. For example, you might have several departments in your organization with different translation needs. One department translates technical publications and another translates legal documents. Because each department has different translation requirements and translation resources, each department might have their own portal.

  1. In the Translation Hub section of the Google Cloud console, go to the Portals page.

    Go to the Portals page

  2. Click Create portal, which opens the Create new portal pane.

    1. Specify a portal display name that describes the purpose of this portal.

    2. Select the portal tier and then click Create.

      Translation Hub creates your portal and lists it on the Portals page. You can view details about your portal, such as its URL, by clicking the name of your portal.

After you create a portal, Translation Hub also assigns a service account to the portal. Add this service account to your Google Cloud project, which is required before users can use translation resources such as glossaries.

Add a service account

Add a portal's service account as a principal in your project and grant the service account access to Translation Hub.

A service account is used by an application, not a person, to authorize API calls to your project. Each Translation Hub portal has a unique service account, which Translation Hub uses to access translation resources on behalf of portal users.

  1. In the Translation Hub section of the Google Cloud console, go to the Portals page.

    Go to the Portals page

  2. From the list of portals, find the portal that you recently created.

  3. In the Service account column, copy the entire service account name, which ends with @gcp-sa-translationhub.iam.gserviceaccount.com.

  4. Go to the IAM page.

    Go to the IAM page

  5. Click Grant access.

  6. In the New principals field, paste your portal's service account name.

  7. Click Select a role and then select the Translation Hub Portal User role.

    The role grants translation-specific permissions. To see the exact set of permissions, see the assigned permissions in the Google Cloud console.

  8. Click Save.

Invite users and add them to portals

Invite users to your Google Cloud project and then add them to portals. When you invite users, you set their sign-in method and select which portals they can access.

You can add users to one or more portals in a single project. If users are added to multiple portals, they choose which one to use after signing in. If you're using Translation Hub in multiple projects, you can invite users to only one project.

  1. In the Translation Hub section of the Google Cloud console, go to the Users page.

    Go to the Users page

  2. Click Invite user.

  3. Select the Portal user tab and then click Continue.

  4. Select Add manually to invite one user or Bulk import via a CSV file to invite multiple users in a single request, and then click Continue.

  5. Specify user details:

    • To manually add one user, specify the user's email address, sign-in method, and the portals they can access. The sign-in method specifies whether users sign in with an email and password or with their Google Account (such as a Google Workspace account).

    • To invite users in bulk, provide a CSV file where each line specifies a user's email address, sign-in method, and associated portals. You can specify an existing file in Cloud Storage or upload a local file to Cloud Storage. In either case, Translation Hub requires Cloud Storage permissions. For more information, see CSV file for bulk import and Service account for adding users in bulk.

  6. Click Done.

    Users with the GOOGLE sign-in method can access portals by going to https://translationhub.cloud.google.com/. Users with the EMAIL_PASSWORD sign-in method receive an email notification with a portal URL; they can also sign in by going to https://translationhub.cloud.google.com/.

    On the Portal users tab on the Users page, you can the view status of each user: Registered or Invited. Registered users have signed in at least once.

CSV file for inviting users in bulk

To add multiple users in a single request, specify user information in a CSV file. Each line of the CSV file uses the following format that contains the user's email address, sign-in method, and portal IDs:


The sign-in method can be google for Google Accounts or email/password for all other email addresses. The portal IDs are listed on the Portals page in the Google Cloud console. Use a semicolon to associate multiple portals to a single user.

The following example shows a sample CSV. Don't include a header row for column names.


Translation Hub has a limit on the number of rows and CSV file size. For more information, see usage limits in Quotas and limits.

Add Cloud Storage permission to Translation Hub

Translation Hub reads your bulk-import CSV file from a Cloud Storage bucket. Translation Hub doesn't inherently have permissions to access Cloud Storage. To allow access, grant the Translation Hub service account the Storage Admin role, which allows Translation Hub to upload and read CSV files from your Cloud Storage buckets.

  1. Go to the IAM page.

    Go to the IAM page

  2. From the list of principals, check to see if the cloud-translation-hub@system.gserviceaccount.com service account already exists with the Storage Admin role. If not, proceed to the next step. If the service account already exist, skip these steps.

  3. Click Grant access.

  4. For the New principals field, add cloud-translation-hub@system.gserviceaccount.com as a principal.

  5. Click Select a role and then select the Storage Admin role.

    The role grants permissions for Translation Hub to add and read files in Cloud Storage buckets. To see the exact set of permissions, see the assigned permissions in the Google Cloud console.

  6. Click Save.

What's next