Configuring Bible Translations
Bible translation settings control which translations an Agent may quote and which one it reaches for first.
Purpose
Select the Bible translations an Agent can use, set a default translation for each language, and supply the provider credentials those translations require.
Prerequisites
- A configured Agent with its languages set. See Configuring Languages.
- Approved translation choices for your ministry, including any licensing your use requires.
- An API key for each paid provider whose translations you plan to use.
Steps
Open the Agent's Scripture Settings
Select Agents in the left-hand navigation, open your Agent, then choose the General page and the Scripture tab.

Check the Page Language First
Both translation fields are filtered by the language selected in the page language switcher, in the top right. Each field shows the active language beside its label.
This matters because a Default Bible Translation is stored separately for every language. Set the switcher to the language you are configuring before you change either field, and repeat these steps for each language the Agent supports.
Select the Supported Translations
In Supported Bible Translations, search for and select the translations the Agent may quote in the active language. A language with no translation of its own lists a related one instead: Dari lists Persian, and those entries are labeled Persian.
Leaving the field blank allows every available translation for the language in the list. Selecting translations restricts the Agent to your approved list.
Your selections in other languages are preserved while you work. The page language changes what you see, never what is saved.
Set the Default Translation
Default Bible Translation is the edition the Agent quotes when the message does not send a translation that fits the reply language. Choose it from the translations available in the active language.
Add the Provider API Keys
Each translation comes from a provider, and the paid providers authenticate with a key. In Provider API Keys, fill in the key for each provider represented in your selection:
- API.Bible API Key
- YouVersion API Key
A key becomes required once your selection includes a translation from that provider. AO Lab translations are free and need no key, as the section notes.
Keys are stored as secrets and masked in the field. Use the reveal control beside a field if you need to confirm what you pasted.
Adjust the Scripture Instructions (Optional)
Expand Advanced Scripture Settings to edit Bible Tool Instructions, which tells the Agent how to use the scripture lookup tool. It supports the bible merge tag, which resolves to the current Bible translation.
Console keeps these instructions in step with your translation choices, so change them only when you need behavior the default does not give you. The field is unavailable when your selection draws only on the model’s own knowledge rather than a lookup provider.
Expected Result
The Agent quotes scripture from your approved translations, defaults to your chosen translation in each language, and authenticates to each paid provider successfully.
How the Bible Translation Is Chosen
On the Agent’s site, the translation selector lists translations for the page language. A translation in the address is used when it is in that list. Otherwise the selector uses a choice saved for this Agent and language, then the default you set, then the first translation in the list. Choosing Auto in the language selector does not send the translation showing on the page.
A language that borrows scripture still uses its fallback scripture language when the visitor named it.
A translation matches when it is in the effective Bible language. Dari accepts Persian. The default, the selected list, and the AO Lab editions are read in that language.
Cautions
Confirm licensing and attribution requirements with the rights holder before you make a translation publicly available through an Agent. Provider access does not by itself grant redistribution rights for every use.
Treat provider keys as secrets. Enter them only in the Provider API Keys fields, and keep them out of documentation, screenshots, shared prompts, and support tickets.
Troubleshooting
- A translation is missing from the list. The list is filtered to the language in the page language switcher. Change the switcher to the translation’s language. Dari has no translation of its own, so that language lists Persian until a Dari translation exists.
- The form will not save and a key field is marked required. Your selection includes a translation from a provider with no key entered. Add the key or remove that translation.
- The default translation is right in one language and wrong in another. Defaults are stored per language. Switch the page language and set the default again there.
- Bible Tool Instructions cannot be edited. Either your selection uses no lookup provider, or instruction editing is not included in your team’s current plan.
Next Step
Continue to Configuring Scripture Plugins to attach hosted or external replacements beside those quotations.
