Skip to content

[Doc Improvement][Update localization.json] #12738

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open

[Doc Improvement][Update localization.json] #12738

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
5b0543c
Update apps-localization.md
v-santhoshs1 Apr 24, 2025
b4d40fd
Update apps-localization.md
v-santhoshs1 Apr 28, 2025
4b054a6
Update apps-localization.md
v-santhoshs1 Apr 28, 2025
505f6ad
edits
v-santhoshs1 Apr 28, 2025
c54508d
Merge branch 'main' into doc-improvement-localization.json
v-santhoshs1 Apr 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 9 additions & 9 deletions msteams-platform/concepts/build-and-test/apps-localization.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ The images that you upload with the English language are used in AppSource.

## Localize strings in your app manifest

Use the Microsoft Teams app schema `v1.5` and later to localize your app. You can do this by setting the `$schema` attribute in your manifest.json file to `https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.schema.json` or higher and updating the `manifestVersion` property to `$schema` version (`1.5` in this case).
Use the Microsoft Teams app schema `v1.21` and later to localize your app. You can do this by setting the `$schema` attribute in your manifest.json file to `https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json` or higher and updating the `manifestVersion` property to `$schema` version (`1.21` in this case).

Add the `localizationInfo` property with the default language that your application supports. The default language is used as the final fallback language if the user's client settings don't match with any of your additional languages.

Expand All @@ -52,8 +52,8 @@ The following `manifest.json` helps to add the `localizationInfo` property with

```json
{
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
"manifestVersion": "1.5",
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json",
"manifestVersion": "1.21",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this localization is working after doing version changes for manifest schema and localization schema?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From Ajay: This is a platform issue where the localization is not working. An issue/bug is raised for the same.

"localizationInfo": {
"defaultLanguageTag": "en",
"additionalLanguages": [
Expand All @@ -67,14 +67,14 @@ The following `manifest.json` helps to add the `localizationInfo` property with
}
```

### Example localization .json change
### Example localization.json change
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please check the versions of it and update those accordingly.
Currently we are using different versions.


Following is an example for localization .json:
Following is an example for localization.json:

```json
{
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.5/MicrosoftTeams.Localization.schema.json",
"manifestVersion": "1.5",
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.Localization.schema.json",
"manifestVersion": "1.21",
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this localization is working after doing version changes for manifest schema and localization schema?

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Chetan it's not working on older as well as latest version and other user have also reported this issue we have raised a bug for that.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ChetanSharma-msft - Ajay is yet to confirm.

"name.short": "Localización",
"name.full": "Aplicación de localización",
...
Expand Down Expand Up @@ -127,13 +127,13 @@ The `manifest.json` change is shown in the following example:
}
```

### Example localization .json file
### Example localization.json file

The `localization.json` change is shown in the following example:

```json
{
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.8/MicrosoftTeams.Localization.schema.json",
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.Localization.schema.json",
"name.short": "Le App",
"name.full": "App pour Microsoft Teams",
"description.short": "Créez d'excellentes applications pour Microsoft Teams avec App.",
Expand Down
6 changes: 3 additions & 3 deletions msteams-platform/resources/schema/manifest-schema.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ ms.date: 1/30/2025

# App manifest

The app manifest (previously called Teams app manifest) describes how your app integrates into the Microsoft Teams product. Your app manifest must conform to the schema hosted at [https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json](https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json). Previous versions 1.0, 1.1,...,1.20, and the current version is 1.21 are each supported (using "v1.x" in the URL). Version 1.18 is not available.
The app manifest (previously called Teams app manifest) describes how your app integrates into the Microsoft Teams product. Your app manifest must conform to the schema hosted at [https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json](https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json). Previous versions 1.0, 1.1,...,1.19, 1.20, and the current version is 1.21 are each supported (using "v1.x" in the URL). Version 1.18 is not available.
For more information on the changes made in each version, see [app manifest change log](https://github.com/OfficeDev/microsoft-teams-app-schema/releases) and for previous versions, see [app manifest versions](https://github.com/microsoft/json-schemas/tree/main/teams).

The following table lists TeamsJS version and app manifest versions as per different app scenarios:
Expand All @@ -24,8 +24,8 @@ The following is the sample app manifest schema:

```json
{
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.20/MicrosoftTeams.schema.json",
"manifestVersion": "1.20",
"$schema": "https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json",
"manifestVersion": "1.21",
"version": "1.0.0",
"id": "%MICROSOFT-APP-ID%",
"localizationInfo": {
Expand Down