AI Intranet TranslationHelp & documentation

Set up and use
AI Intranet Translation.

Overview

AI Intranet Translation adds a language switcher to the header of every modern SharePoint page. Readers select a language and the text of the page they are on is translated. Original shows the page exactly as it was written.

135+ languages, including right-to-left languages such as Arabic and HebrewLinks, formatting and line breaks are keptThe chosen language follows the reader from page to page during their visitTranslations are stored and reused until the page changesEvery translation is labelled as AI-generated, with one-click reporting

What's in the package: one SharePoint Framework (SPFx) Application Customizer extension, deployed tenant-wide.

Requirements
SharePoint OnlineModern SharePoint sites and pages in Microsoft 365.
SubscriptionAI Intranet Translation from Microsoft Marketplace.
AzureAn Azure subscription for Azure AI Foundry and Azure Storage, billed separately by Microsoft.
Admin rolesA Global Administrator or SharePoint Administrator for setup.
Get started · about 5 minutes

1. Subscribe and activate

  1. Open AI Intranet Translation on Microsoft Marketplace and select a plan.
  2. After purchase you are taken to the Tealdroid landing page. Sign in with your work account and select Activate subscription.

2. Add the app to SharePoint

  1. In the SharePoint admin center → More features → Apps, add AI Intranet Translation to your tenant App Catalog, or upload ai-intranet-translation.sppkg to Apps for SharePoint.
  2. When asked, select Enable this app and add it to all sites immediately, then Enable app.

3. Approve API access

  1. Open SharePoint admin center → Advanced → API access.
  2. Under Pending requests, select AI Translation for SharePoint – user_impersonation and choose Approve.
Seeing "The requested permission isn't valid"? The app's sign-in registration isn't in your tenant yet. A Global Administrator can add it by opening https://login.microsoftonline.com/<your-tenant-id>/adminconsent?client_id=8a91ed03-a9a4-4c78-b8ef-89f09f678223 and selecting Accept. Then reject the old request, add the app again and approve the new request.

4. Connect your Azure resources

Open any modern SharePoint page as a Global or SharePoint Administrator and select Connect Azure in the page header. Choose one of two options:

Set up in Azure (Automatic)
  • Creates an Azure AI Foundry resource, a chat model deployment and a Storage account for you
  • Paste a short-lived ARM access token (see below)
  • Enter the subscription ID, resource group, region and resource names
  • Select Run Automated Provisioning
Enter details manually
  • Uses Azure resources you already have
  • Azure AI Foundry endpoint, API key and chat deployment name
  • Storage account name and key, and a blob container (default page-translations)
  • Select Save & Test Connection

ARM access token: in the Azure portal Cloud Shell (Bash), run:

az account set --subscription "<your-subscription-id>"az account get-access-token --resource https://management.azure.com/ --query accessToken -o tsv

Your account needs Contributor or Owner access to the subscription. Treat the token like a password.

5. Choose languages

Select the gear icon at the end of the language switcher, add the languages your organisation needs and select Save settings.

Translation settings

Global and SharePoint Administrators see a gear icon at the end of the switcher. Settings apply to the whole organisation.

Translation settings dialog with languages, switcher style and accent colour
Supported languages, switcher style and accent colour.
Supported languages: search 135+ languages by name or codeSwitcher style: Glass, Pill, Minimal or ElevatedAccent colour: your own colour, or the site theme colourAzure AI Foundry & Storage: change the connected resources at any time
Translating pages
SharePoint page with the language switcher in the header
The language switcher sits in the SharePoint header, next to search.
  1. Open any modern SharePoint page.
  2. Select a language in the switcher. The page text is translated in place.
  3. Select Original (or the active language again) to see the page as it was written.

Extra languages are under the + menu. Right-to-left languages switch the page direction automatically, the chosen language is applied to each page you open, and the switcher works with the keyboard.

SharePoint page translated into Arabic, shown right to left
A page translated into Arabic, shown right to left.
AI content & reporting

Translations are generated by an AI model. Whenever a page is translated, a notice at the bottom of the page says "Translated by AI into [language] · may contain mistakes".

Notice reading Translated by AI, with a Report translation link
The AI notice with the Report translation link.

Report a translation: if a translation is inaccurate, offensive or inappropriate, select Report translation. Your mail app opens a message to support@tealdroid.com with the page address, language and time filled in.

Data & privacy
Page text is sent from the reader's browser to the AI Intranet Translation service, which translates it with your organisation's Azure AI Foundry model.Translations are stored in your organisation's Azure Storage account and reused until the page changes.The API keys you enter for your Azure resources are kept in Azure Key Vault.Translation happens in the reader's browser only. Your SharePoint pages are never changed.Only signed-in users of a licensed organisation can use the service.

See our privacy notice and terms.

Troubleshooting

If something needs attention, administrators see a button in the page header instead of the switcher. Readers see nothing until it is fixed.

Approve API accessThe API request hasn't been approved yet.Follow step 3 below. The button opens the API access page.
Get a licenseYour organisation has no active subscription.Subscribe on Microsoft Marketplace and activate it.
Connect AzureNo Azure resources are connected yet.Follow step 4 below.
Translation unavailable · RetryThe translation service couldn't be reached.Select it to try again. If it continues, contact support.
Common problems
Frequently asked questions
Support
Contact form: tealdroid.com/contactEmail: ravichandran@tealdroid.comReport AI-generated content: support@tealdroid.com, or Report translation on any translated page
Ready to translate your intranet?