Brand Concierge Implementation Guide (iOS)

The Brand Concierge UI is presented in two steps:

• Enable UI presentation by wrapping your SwiftUI root with Concierge.wrap(...)
• Open the chat by calling Concierge.show(...)

Internally, Concierge.show(...) dispatches an event in the Adobe Experience Platform Mobile SDK that the Concierge extension handles to build a ConciergeConfiguration, then the SwiftUI overlay presents ChatView.

Prerequisites

Required SDK modules

Your app needs the following Experience Platform SDKs to be available and registered:

• AEPCore (MobileCore; Configuration shared state from configureWith(appId:))
• AEPEdge
• AEPEdgeIdentity
• AEPBrandConcierge

iOS version

• Minimum iOS 15.0+

Permissions for speech to text (optional)

Speech to text uses iOS Speech and microphone APIs. Add these to your app Info.plist:

• NSMicrophoneUsageDescription
• NSSpeechRecognitionUsageDescription

Configuration

Step 1: Set up the Adobe Experience Platform Mobile SDK

Follow the Adobe Experience Platform Mobile SDK getting started guide to set up the base SDK integration used by Concierge.

The required extensions are:

• AEPCore
• AEPEdge
• AEPEdgeIdentity
• AEPBrandConcierge

Step 2: Validate the Brand Concierge configuration keys

If you set the Adobe Experience Platform SDK log level to trace:

Copy
MobileCore.setLogLevel(.trace)
Copied to your clipboard
MobileCore.setLogLevel(.trace)

you can then inspect the app logs to confirm that extension shared states are being set with the expected values.

Brand Concierge expects the following keys in the Configuration shared state:

• concierge.server: String (server host or base domain for Concierge requests)
• concierge.configId: String (datastream ID)

The ECID is read from the Edge Identity shared state.

Another option for validation is to use Adobe Assurance. Refer to the Mobile SDK validation guide for more information.

Optional styling

Theme injection (recommended)

The Brand Concierge chat interface can be customized by loading a theme JSON and applying it above Concierge.wrap(...) so both the floating button and the overlay use it. The UI reads styling from the SwiftUI environment value conciergeTheme:

Copy
let theme = ConciergeThemeLoader.load(from: "theme-default", in: .main) ?? ConciergeThemeLoader.default()

var body: some View {
    Concierge.wrap(AppRootView(), surfaces: ["my-surface"], hideButton: true)
        .conciergeTheme(theme)
}
Copied to your clipboard
let theme = ConciergeThemeLoader.load(from: "theme-default", in: .main) ?? ConciergeThemeLoader.default()

var body: some View {
    Concierge.wrap(AppRootView(), surfaces: ["my-surface"], hideButton: true)
        .conciergeTheme(theme)
}

More information regarding theme customization can be found in the Style guide (iOS).

Basic usage

Option A — Manual API call (no floating button)

Use this when you want full control over where the entry point lives.

1. Wrap your root content and hide the built-in button:

Copy
Concierge.wrap(AppRootView(), surfaces: ["my-surface"], hideButton: true)
Copied to your clipboard
Concierge.wrap(AppRootView(), surfaces: ["my-surface"], hideButton: true)

2. Trigger chat from your own UI:

Copy
Button("Chat") {
    Concierge.show(surfaces: ["my-surface"], title: "Concierge", subtitle: "Powered by Adobe")
}
Copied to your clipboard
Button("Chat") {
    Concierge.show(surfaces: ["my-surface"], title: "Concierge", subtitle: "Powered by Adobe")
}

Concierge.show() also accepts optional parameters:

• speechCapturer: A SpeechCapturing implementation for voice input (a default is created internally if not passed).
• textSpeaker: A TextSpeaking implementation for text-to-speech (off by default unless you supply one).
• handleLink: A callback invoked when a link is tapped in the chat. See Link Handling for details.

Option B — Floating button (built-in)

Use this for a drop-in entry point:

Copy
Concierge.wrap(AppRootView(), surfaces: ["my-surface"]) // hideButton defaults to false
Copied to your clipboard
Concierge.wrap(AppRootView(), surfaces: ["my-surface"]) // hideButton defaults to false

This shows a floating button in the bottom trailing corner; tapping it calls Concierge.show(surfaces:).

Concierge.wrap() also accepts optional parameters:

• title: Title shown in the chat header.
• subtitle: Subtitle shown under the title.
• handleLink: A callback invoked when a link is tapped in the chat. See Link Handling for details.

Closing the UI

Dismiss the overlay from code with:

Copy
Concierge.hide()
Copied to your clipboard
Concierge.hide()

UIKit usage

Use this when your app is UIKit-based and you want to present Concierge from a UIViewController.

Present the chat UI

Call Concierge.present(on:surfaces:title:subtitle:) from the view controller that should host the chat:

Copy
import AEPBrandConcierge

final class MyViewController: UIViewController {
    @objc private func openChat() {
        Concierge.present(on: self, surfaces: ["my-surface"], title: "Concierge", subtitle: "Powered by Adobe")
    }
}
Copied to your clipboard
import AEPBrandConcierge

final class MyViewController: UIViewController {
    @objc private func openChat() {
        Concierge.present(on: self, surfaces: ["my-surface"], title: "Concierge", subtitle: "Powered by Adobe")
    }
}

Dismiss the chat UI

To dismiss the presented UI:

Copy
Concierge.hide()
Copied to your clipboard
Concierge.hide()

Link Handling

Universal Links

To have the SDK open http/https URLs natively in your app instead of the in-app WebView, configure Associated Domains for your app and host an apple-app-site-association file on your domain. When the domain is verified, tapping a link for that domain in the chat will navigate within your app instead of the WebView.

Alternatively, use the handleLink callback to intercept specific domains and handle them with custom navigation logic without requiring domain verification.

Default behavior

When a user taps a link in the chat, the SDK routes it through ConciergeLinkHandler using the following flow:

1. Custom scheme URLs (e.g. myapp://, mailto:, tel:) — opened immediately via the system (deep link).
2. http/https URLs — the system is first asked to open the URL as a universal link. If the host app has registered the URL's domain via Associated Domains, the app handles the navigation natively. Otherwise, the URL falls back to the in-app WebView overlay.

Default link handling flow: handleLink callback (if provided) → deep link / universal link check → WebView overlay.

Custom link handling

All three public APIs accept an optional handleLink closure that is called before the SDK's default routing. Return true to claim the URL (the SDK takes no further action). Return false to let the SDK handle it normally.

SwiftUI — Concierge.wrap():

Copy
Concierge.wrap(
    AppRootView(),
    surfaces: ["my-surface"],
    hideButton: true,
    handleLink: { url in
        if url.scheme == "myapp" {
            Concierge.hide()
            // Navigate to in-app destination
            return true
        }
        return false
    }
)
Copied to your clipboard
Concierge.wrap(
    AppRootView(),
    surfaces: ["my-surface"],
    hideButton: true,
    handleLink: { url in
        if url.scheme == "myapp" {
            Concierge.hide()
            // Navigate to in-app destination
            return true
        }
        return false
    }
)

SwiftUI — Concierge.show():

Copy
Concierge.show(
    surfaces: ["my-surface"],
    title: "Concierge",
    subtitle: "Powered by Adobe",
    handleLink: { url in
        if url.host == "myapp.example.com" {
            Concierge.hide()
            return true
        }
        return false
    }
)
Copied to your clipboard
Concierge.show(
    surfaces: ["my-surface"],
    title: "Concierge",
    subtitle: "Powered by Adobe",
    handleLink: { url in
        if url.host == "myapp.example.com" {
            Concierge.hide()
            return true
        }
        return false
    }
)

UIKit — Concierge.present(on:):

Copy
Concierge.present(
    on: self,
    surfaces: ["my-surface"],
    title: "Concierge",
    subtitle: "Powered by Adobe",
    handleLink: { url in
        if url.scheme == "myapp" {
            Concierge.hide()
            // Navigate using UIKit navigation
            return true
        }
        return false
    }
)
Copied to your clipboard
Concierge.present(
    on: self,
    surfaces: ["my-surface"],
    title: "Concierge",
    subtitle: "Powered by Adobe",
    handleLink: { url in
        if url.scheme == "myapp" {
            Concierge.hide()
            // Navigate using UIKit navigation
            return true
        }
        return false
    }
)

When handleLink returns true, the SDK does not open the WebView overlay or perform any further link routing. When it returns false or is not provided, the SDK uses the default flow (deep link check → universal link check → WebView overlay).

Next steps

• Style guide (iOS) — Theme JSON reference and implementation status for iOS.

Last updated 3/19/2026

Was this helpful?

Yes

No