Emby Emby Emby Learn
  • Emby Home
  • Video
  • Audio
  • Media Files
    • Subtitles and captions
    • Photos and images
    • Metadata and discovery
    • Libraries and media collections
    • Playback and streaming
    • Media hardware acceleration
    • Displays and AV connections
    • Live TV and recording
  1. Emby Learn
  2. Subtitles and captions
  3. Track selection and accessibility
  4. Subtitle language preferences
Search Results for

    Show / Hide Table of Contents

    Subtitle language preferences

    Subtitle language preferences guide selection through language identifiers, script/region distinctions and the subtitle content role required for viewing.

    A subtitle language preference tells a player which language the viewer wants to read. It does not determine whether that track contains all dialogue, accessibility captions or just selected passages.

    The player needs language identity and the intended content role.

    Language identifiers can be more specific than a name

    BCP 47 language tags can express language, script and region. For example:

    Tag Meaning
    en English
    en-GB English with a United Kingdom regional distinction
    zh-Hans Chinese using Simplified script
    zh-Hant Chinese using Traditional script

    Script and region are different subtags. A regional label can be associated with a customary script in a library convention, but it is not identical to an explicit script declaration.

    Containers and naming systems can use other representations, including ISO 639 codes or supported language names. A matching system needs to interpret those schemes rather than compare arbitrary display strings.

    Emby's external naming documentation describes supported language identification in filenames. The format's cue text remains a separate property from that label.

    Language matching does not resolve the role

    Suppose a viewer prefers English and sees these candidates:

    Candidate Language match Remaining question
    English dialogue Yes Is dialogue-only content sufficient?
    English SDH Yes Are sound/speaker descriptions desired?
    English forced passages Yes Should only the required selected passages appear?
    Spanish full dialogue No Is another language being explicitly selected?

    A hearing-impaired preference may distinguish the first two. A forced-only mode can distinguish a sparse required-passage track from a full translation. The selected audio language can also be relevant to a policy that decides when translation is needed.

    A track title is a useful clue, but incorrect metadata can make the choice disagree with the actual text. Inspecting its contents establishes what the resource supplies.

    The current viewing choice can override a general preference

    A viewer can explicitly choose another language for one film. A player can remember that selection. Changing a preferred language and choosing a specific track are different operations with different scope.

    Emby's preference documentation is the appropriate source for its selection controls. For a surprising result, compare the active choice, remembered selection, language identifiers and role metadata before assuming that the language decoder is broken.

    See Also

    • Subtitle track selection
    • Subtitles for the deaf and hard of hearing (SDH)
    • Forced subtitles
    • Track Language Metadata

    References

    • RFC 5646: Language tags
    • RFC 9559: Matroska container format
    • RFC 8216: HTTP Live Streaming
    On this Page
    2026 © EMBY LLC. Please see our terms of use and privacy policy.
    Back to Top