Monkeybread Software - MBS FileMaker Plugin: Translation.IsReady

Components	All	New	MacOS		Windows		Linux		iOS
Examples	Mac & Win		Server	Client	Guides	Statistic	FMM	Blog	Deprecated	Old

Translation.IsReady

Checks whether the session is ready to translate.

Component	Version	macOS	Windows	Linux	Server	iOS SDK
Translation	16.0	✅ Yes	❌ No	❌ No	❌ No	✅ Yes

MBS( "Translation.IsReady"; SessionID ) More

Parameters

Parameter Description Example

SessionID The translation session. $session

Parameter	Description	Example
SessionID	The translation session.	$session

Result

Returns 1, 0 or error.

Description

Checks whether the session is ready to translate.
Queries a boolean value that indicates whether the system has installed the source and target languages of the session and is ready to begin translation.

Use this property to check whether a translation is likely to succeed. In a session that can request downloads, it prompts the person to approve downloads if languages aren't ready yet. In a session that can't request downloads, it will throw an error if the person calls any functions when languages aren't ready.

Note: This value returns whether the languages are currently installed. The person or system can still delete the downloaded languages after calling this, so make sure you handle the appropriate errors when calling one of the translate functions.

Requires macOS 15/26 or iOS 18/26 or later.

Examples

Check status:

Set Variable [ $session ; Value: MBS( "Translation.StartSession"; "de"; "en") ]
If [ MBS( "Translation.IsReady"; $session ) ]
Show Custom Dialog [ "We can translate German to English." ]
Else
Show Custom Dialog [ "Please go to system preferences. You may need to download language files." ]
End If
Set Variable [ $r ; Value: MBS( "Translation.Release"; $session) ]
Check status:

<?xml version="1.0" encoding="UTF-8"?>
<fmxmlsnippet type="FMObjectList">
  <Step enable="True" id="141" name="Set Variable">
    <Value>
      <Calculation>MBS( "Translation.StartSession"; "de"; "en") </Calculation>
    </Value>
    <Repetition>
      <Calculation>1</Calculation>
    </Repetition>
    <Name>$session</Name>
  </Step>
  <Step enable="True" id="68" name="If">
    <Restore state="False"/>
    <Calculation> MBS( "Translation.IsReady"; $session ) </Calculation>
  </Step>
  <Step enable="True" id="87" name="Show Custom Dialog">
    <Title>
      <Calculation> "We can translate German to English." </Calculation>
    </Title>
    <Message>
      <Calculation/>
    </Message>
    <Buttons>
      <Button CommitState="True">
        <Calculation>"OK"</Calculation>
      </Button>
      <Button CommitState="False">
        <Calculation>"Cancel"</Calculation>
      </Button>
      <Button CommitState="False"/>
    </Buttons>
  </Step>
  <Step enable="True" id="69" name="Else">
    <Restore state="False"/>
  </Step>
  <Step enable="True" id="87" name="Show Custom Dialog">
    <Title>
      <Calculation> "Please go to system preferences. You may need to download language files." </Calculation>
    </Title>
    <Message>
      <Calculation/>
    </Message>
    <Buttons>
      <Button CommitState="True">
        <Calculation>"OK"</Calculation>
      </Button>
      <Button CommitState="False">
        <Calculation>"Cancel"</Calculation>
      </Button>
      <Button CommitState="False"/>
    </Buttons>
  </Step>
  <Step enable="True" id="70" name="End If"/>
  <Step enable="True" id="141" name="Set Variable">
    <Value>
      <Calculation>MBS( "Translation.Release"; $session) </Calculation>
    </Value>
    <Repetition>
      <Calculation>1</Calculation>
    </Repetition>
    <Name>$r</Name>
  </Step>
</fmxmlsnippet>

Blog Entries

Translation Framework in FileMaker

This function is free to use.

Created 24th November 2025, last changed 7th January 2026

Translation.DetectLanguage - Translation.List