Configuring placements
Create and customise placements for each embeddable agent — where it appears, how it looks, and how it answers.
A placement is one configured instance of an embeddable agent: where it appears, what it looks like, and how it answers. You can create several placements for the same agent — for example, one Virtual Try-On tuned for shoes on your shoe pages and another tuned for dresses on your dress pages.
Navigating to settings
Log in to your Alhena AI dashboard.
In the sidebar, click Integrations.
Choose the embeddable agent you want to set up — for example, Embeddable Virtual Try-On.
Click Configure settings.
The placement list
The first screen shows every placement you've created for that agent.
Drag to reorder. When a shopper loads a page, the agent shows the first placement whose conditions match that page, working from the top down. Drag placements to set their priority.
Status. Each placement is Enabled or Disabled. Disabled placements never show to shoppers.
Appears on. A short summary of the page conditions for each placement.
Click Create placement to add a new one, or Configure settings on an existing row to edit it.
A placement with no conditions acts as the default — it shows wherever you place the snippet and no other placement matches the page. Keep your most specific placements near the top and a catch-all default at the bottom.
The placement editor
Each placement opens in an editor with up to three tabs: Style, Setup, and Playground.
Style tab
The Style tab controls everything the shopper sees. The left side is the form; the right side is a live Preview that updates as you type. Every field is optional — leave one blank and the agent falls back to a sensible default.
Placement
Show this placement to shoppers — the enable/disable switch.
Name — an internal label so you can recognise this placement in your list (for example, "Shoes — collection page"). Shoppers never see it.
When a shopper taps it — choose Answer in the panel or Open in chat. (See Where the answer appears.)
Opening message — the message the agent receives when the panel opens. Leave blank to use the agent's default.
Button
Button label — the text on the launcher button (for example, "Try on").
Launcher icon — upload a custom icon, or keep the default sparkle.
Accent color — the colour of the button and the panel's accents. Use your brand colour.
Corner radius — how rounded the button and panel are.
Panel (the container that opens)
Title and Subtitle — the heading and subheading shown at the top of the panel.
Background color and Show panel border — match the panel to your page.
Width and Height — the panel size on desktop. On mobile the panel is always full-width.
Fonts, text colours, and spacing are inherited from your storefront automatically, so the panel blends into your page without extra styling.
Photo step (Virtual Try-On and See It In Your Room only)
Photo step heading and subtext — the instructions shown on the upload screen (for example, "Upload a full-body photo").
Choose-photo button label — the button that opens the file picker.
Photo disclaimer — the privacy wording shown next to the upload. Whether a consent step is required follows your Website Chat settings.
Waiting (agents that produce a result — everything except the Product Quiz)
Working message — what the shopper sees while the result is generating (for example, "Creating your try-on — this can take a minute…").
Result (Virtual Try-On and See It In Your Room only)
Try-another button label — lets the shopper try a different photo after seeing the result.
Preview states
The Preview on the right has a row of buttons — Button, Photo step, Ready, Waiting, Result — that step through exactly what a shopper sees at each stage. The available states depend on the agent (a Product Quiz, for instance, has no photo or result state). Walk them in order to check your copy and colours at every step.
Setup tab
The Setup tab controls where the placement appears and how it's installed.
Where it appears
Click Add condition to limit this placement to specific pages. Each condition can match by:
Page URL — contains, equals, starts with, or ends with a value.
Page title — the same operators, matched against the page's title.
All conditions must match for the placement to show. With no conditions, the placement is the default for that agent (shown wherever the snippet is placed and no higher placement matches).
Install and Auto-insert — these cover putting the agent on your website and are described in detail on the Installation page.
Playground tab
The Playground is a live test bench — run the real agent on a page before you publish, without installing anything on your site.
Pick a Language.
Pick a Product (for Virtual Try-On, Outfit Builder, See It In Your Room, and Room Designer) or a Page URL (for the Product Quiz).
Use the panel exactly as a shopper would — upload a photo, generate a try-on, or take the quiz.
Every time you change the language or product, the Playground starts a fresh session, so you can re-test cleanly.
Saving
Click Save changes (or Create placement for a new one) to publish. Changes go live within a few minutes. To remove a placement, open it and click Delete placement.
Last updated