Configuration

Branding

View as Markdown

A new Agent opens with a stock greeting, the Apologist AI mark, and a default color. This guide replaces all three with your own.

Purpose

Make the Agent your visitors see carry your ministry’s wording, mark, and colors, and credit the ministry behind it.

Prerequisites

  • An Agent. Create one first in Quickstart.
  • White labelling on your team’s plan. The intro text is available on every plan. The logo, colors, and attribution are not.
  • Standalone Web UI or Embedded Web Widgets turned on for the Agent, under General > Capabilities. Without one of them, Branding does not appear in the row of pages.

What Your Plan Allows

Only the intro text is available on every plan. Everything else on this page, and all of Advanced Branding, needs white labelling.

SettingWhereNeeds white labelling
Intro textMessaging > IntroNo
Theme and Primary ColorBranding > ColorsYes
Header Logo and FaviconBranding > LogoYes
AttributionMessaging > AttributionYes
Footer, page metadata, background, fonts, custom styles, transition messagesAdvanced BrandingYes

Restricted fields are visible rather than hidden. If you can see them but cannot edit them, and an upgrade notice sits above them, white labelling is not on your team’s plan. Confirm your subscription tier, or set the intro text alone, which is not restricted.

For the background, fonts, footer, page metadata, and custom styles, continue to Advanced Branding once you have finished here.

Messaging and Branding are two sibling pages in the row across the top of the Agent, and each saves on its own. The steps below move between them twice, so save before each move, or the change you made on the first is lost.

Steps

1

Write the Intro Text

Choose Messaging from the row of pages across the top, then the Intro tab.

These fields are not empty. A new Agent arrives with Intro Preamble and Intro Headline already holding the greeting you saw at the end of Quickstart, so you are replacing wording rather than supplying it for the first time. Intro Description sets the line beneath the greeting.

The Intro tab of the Seeker Agent's Messaging page in Console, showing Intro Preamble, Intro Headline, and a rich text Intro Description filled in.

Intro text is stored per language, and an Agent shows nothing where it has no text in the visitor’s language. If you support more than one language, set the intro in each of them, or visitors in the others arrive at an empty greeting. Switch languages with the selector at the top right of the page.

2

Choose the Theme and Primary Color

Choose Branding from the row of pages, then the Colors tab. Theme sets the Agent’s background to light or dark, and Primary Color tints buttons and interactive text.

Set the theme before the logo. It decides which logo will read against the background, and an Agent has one logo rather than one per theme.

The Colors tab of the Seeker Agent's Branding page in Console, showing a Theme selector set to Light and a Primary Color swatch set to a deep blue.
3

Upload the Logo and Favicon

On the Logo tab, upload a Header Logo and a Favicon. The Header Logo replaces the Apologist AI mark at the top of the Agent and doubles as the control that opens the About panel. The Favicon is the icon shown in the browser tab.

Supply a logo that reads against the theme you chose, dark on light or light on dark. The Agent draws the logo at half strength until a visitor points at it, so a faint mark reads as washed out rather than subtle.

The Logo tab of the Seeker Agent's Branding page in Console, showing an uploaded Header Logo and Favicon each displayed as a preview thumbnail.
4

Credit Your Ministry

Return to Messaging and choose the Attribution tab. Creator Name, Creator URL, and Creator Description say who is behind the Agent, and appear in the About panel that opens from the logo.

The Attribution tab of the Seeker Agent's Messaging page in Console, showing Creator Name, Creator URL, and a rich text Creator Description filled in.

Expected Result

Open the Agent at its own address. The greeting, logo, and colors are yours, and selecting the logo opens the About panel carrying your ministry’s name and description.

Light and Dark

The two themes are the same Agent configured twice. Only Theme and the uploaded logo differ between them.

The Seeker Agent on the light theme, with a pale background, the Seeker logo at the top left, the greeting Have questions about faith?, and a question box across the bottom.
The Seeker Agent on the dark theme, with a near black background, the gold and teal Seeker logo at the top left, the greeting Have questions about faith?, and a question box across the bottom.

Pick the theme that suits the site the Agent sits beside, then supply the logo that reads against it.

ThemeAgent backgroundLogo to upload
LightPaleA dark mark
DarkNear blackA light mark

Troubleshooting

  • Branding is missing from the row of pages. The Agent has neither Standalone Web UI nor Embedded Web Widgets turned on. Turn one on under General > Capabilities.
  • The fields cannot be edited, and an upgrade notice sits above them. White labelling is not on your team’s plan. The intro text on Messaging > Intro is still available.
  • The logo looks faded. The Agent draws it at half strength until a visitor points at it. That is deliberate, not a failed upload.
  • The logo is hard to make out. It does not read against the theme. Upload a dark mark for the Light theme and a light one for Dark.
  • The greeting is blank for some visitors. Intro text is stored per language, and an Agent shows nothing where it has none. Set the intro in every language the Agent supports.
  • A change disappeared. Messaging and Branding save separately. Moving between them without saving discards the edit.

Next Step

Continue to Configuring Languages to set the Agent’s language and locale behavior.