<!--
{
  "availability" : [
    "iOS: 17.4 -",
    "iPadOS: 17.4 -",
    "macCatalyst: -",
    "macOS: 14.4 -"
  ],
  "documentType" : "symbol",
  "framework" : "Translation",
  "identifier" : "/documentation/Translation",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "Translation"
    ],
    "preciseIdentifier" : "Translation"
  },
  "title" : "Translation"
}
-->

# Translation

Translate text in your app from one language to another.

## Overview

Offer in-app translations with the Translation framework. You can use the built-in
UI and let the system offer a translation to users on your behalf.
Or you can use the framework to customize the translation experience.

![A conceptual image showing a translation.](images/com.apple.Translation/hero@2x.png)

To offer the built-in system translation experience, anchor the <doc://com.apple.documentation/documentation/SwiftUI/View/translationPresentation(isPresented:text:attachmentAnchor:arrowEdge:replacementAction:)> view modifier to the SwiftUI view containing the text to translate.
Set `isPresented` to true when you want to the built-in system translation UI to appear.
Pass the text to translate to the `text` parameter.

To customize the translation experience use one of the translation tasks such as <doc://com.apple.documentation/documentation/SwiftUI/View/translationTask(_:action:)>. These functions provides you with a  [`TranslationSession`](/documentation/Translation/TranslationSession) that you can use to translate strings of text one at a time, or in a batch. You can check language availability before offering a translation with the [`LanguageAvailability`](/documentation/Translation/LanguageAvailability) class.

## Topics

### Essentials

[Translating text within your app](/documentation/Translation/translating-text-within-your-app)

Display simple system translations and create custom translation experiences.

  <doc://com.apple.documentation/documentation/SwiftUI/View/translationPresentation(isPresented:text:attachmentAnchor:arrowEdge:replacementAction:)>

  <doc://com.apple.documentation/documentation/SwiftUI/View/translationTask(_:action:)>

  <doc://com.apple.documentation/documentation/SwiftUI/View/translationTask(source:target:action:)>

[`TranslationSession`](/documentation/Translation/TranslationSession)

A class that performs translations between a pair of languages.

### Availability

[`LanguageAvailability`](/documentation/Translation/LanguageAvailability)

A check for language support and status.

### Errors

[`TranslationError`](/documentation/Translation/TranslationError)

Error codes describing why the framework can’t perform a translation.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)