How to manage settings

Within the Custom Translator settings page, you can share your workspace, modify your Translator key, and delete workspace.

To access the settings page:

  1. Sign in to the Custom Translator portal.

  2. On Custom Translator portal, select the gear icon in the sidebar.

    Setting Link

Associating Translator Subscription

You need to have a Translator key associated with your workspace to train or deploy models.

If you don't have a subscription, follow the steps below:

  1. Subscribe to create a Translator resource. Follow How to sign up for Translator to subscribe and acquire a Translator key.

  2. Note the key for your Translator subscription. Either Key1 or Key2 is acceptable.

  3. Navigate back to the Custom Translator portal.

Create a new workspace

  1. Select the Create workspace button in Custom Translator sidebar.

    Create new workspace

  2. In the dialog, enter the name of the new workspace.

  3. Select Next.

  4. Choose subscription type.

  5. Select subscription region. The region must match the selected region when Translator resource key was created.

  6. Enter the key for your translator subscription, then select the Save button.

    Create new workspace dialog


Custom Translator does not support creating workspace for Translator Text API resource (a.k.a. Azure key) that was created inside Enabled VNET.

Modify existing key

  1. Navigate to the "Settings" page for your workspace.

  2. Select Change Key.

    How to add key

  3. In the dialog, enter the key for your Translator subscription, then select the Save button.

    How to add key dialog

Manage your workspace

A workspace is a work area for composing and building your custom translation system. A workspace can contain multiple projects, models, and documents.

If different part of your work needs to be shared with different people, then creating multiple workspaces may be useful.

Share your workspace

In Custom Translator you can share your workspace with others, if different part of your work needs to be shared with different people.

  1. Navigate to the workspace "Settings" page.

  2. Select the Add people button in the Sharing settings section.

    Share workspace

  3. On the dialog, enter a comma-separated list of email addresses you want this workspace shared with. Make sure you share with the email address that person uses to sign in to Custom Translator with. Select the appropriate level of sharing permission and select the Save button.

    Share workspace dialog

  4. If your workspace still has the default name "My workspace", you'll be required to change it before sharing your workspace.

  5. Select Save.

Sharing permissions

  1. Reader: A reader in the workspace will be able to view all information in the workspace.

  2. Editor: An editor in the workspace will be able to add documents, train models, and delete documents and projects. They can add a key, but can't modify who the workspace is shared with, delete the workspace, or change the workspace name.

  3. Owner: An owner has full permissions to the workspace.

Change sharing permission

When a workspace is shared, the Sharing settings section shows all email addresses that this workspace is shared with. You can change existing sharing permission for each email address if you have owner access to the workspace.

  1. In the Sharing settings section, for each email, a dropdown menu shows the current permission level.

  2. Choose the dropdown menu and select the new permission level you want to assign to that email address.

    Sharing permission settings

Pin your workspace

Your first created workspace is by default pinned. Each time you sign in, your pinned workspace is displayed upon site load. If you have created many workspaces and desire to make one of them your default when you sign in, you need to pin it.

  1. In the sidebar, select the name of the workspace you want to pin.

  2. Navigate to the "Settings" page for your workspace.

  3. Select the Pin icon.

    Pin workspace

Next steps