---
title: "Build a playlist with AI Mode"
slug: "/help/playlists/ai-mode"
tags: ["playlists","ai-mode","ai","demo center"]
description: "Use AI Mode inside the playlist editor to build sections, pull in demos and assets, write copy, and brand the hub — with a plan you approve and a one-click undo."
product: "playlists"
sidebar_label: "AI Mode"
last_updated: "2026-09-02T15:27:46.529Z"
---

## **Overview**

**AI Mode** lives inside the playlist editor. Ask it for a small change ("write an intro for this section") and it applies the change right away. Hand it a goal ("create a focused playlist — a short intro and a gallery of our best demos, on-brand") and it proposes a plan, then builds the whole hub while you watch it happen on the canvas.

Everything AI Mode does goes through the normal editor and save path, so nothing is hidden: you see each change land, and you can keep it or undo it.

### **Snapshot 📸**
- **Feature Status:** Generally available · consumes AI credits
- **Role Access:** Anyone who can edit the playlist
- **Location:** Playlist editor → **AI Mode** in the top command bar

:::note
AI Mode only appears once your company has accepted the AI terms in **Company Settings → AI**. If the button is missing, that opt-in is the first thing to check.
:::

---

## **Open AI Mode**

1. Open a playlist in the editor.
2. Click **AI Mode** in the top command bar.
3. The panel opens docked to the left of the canvas.

The panel has three states:

- **Docked** — a card pinned beside the canvas.
- **Floating** — drag the panel header (or click **Pop out**) to tear it off into a movable, resizable window. Click **Dock to left** to put it back.
- **Closed** — click **✕**. The **AI Mode** button reopens it.

Your choice is remembered, and the floating window keeps its position and size.

---

## **Two ways to work**

The panel has no Ask/Agent switch — AI Mode reads your prompt and picks the right mode.

### **Quick asks**

Small, well-scoped requests apply immediately:

- "Write a title and intro copy for a section"
- "Update the header title, logo, and styling"
- "Reorder the demos in the gallery"

### **Agent runs**

Bigger goals — building a playlist from scratch, or overhauling one — become an **agent run**. AI Mode first shows a **plan card**: a short summary plus the concrete changes it intends to make, each tagged *added*, *edited*, or *styled*. You choose:

| Choice | What happens |
| --- | --- |
| **Run as agent** | AI Mode executes the whole plan on its own. |
| **Step by step** | It walks the plan one change at a time. |
| **Refine** | Type what should change. AI Mode re-proposes an updated plan instead of executing. |

Once you approve, the card stays in the conversation with a **Plan approved** chip, so you can always scroll back to what was agreed.

---

## **What AI Mode can do in a playlist**

**Structure and content**
- Add, remove, reorder, and move content sections — gallery, carousel, text, banner, embedded, and side-by-side embedded.
- Clear empty sections, or reset the hub to a blank canvas before a from-scratch build.
- Write and rewrite section titles and body copy.

**Pull in your content**
- Search your company's demo library by name, description, tags, folder, owner, or AI summary — and add the best matches to a gallery.
- Search the Resource Hub and add images, videos, and PDFs.
- Add a video by URL (YouTube, Vimeo, or a Walnut-hosted video).
- Set a thumbnail on any content item.

**Branding and styling**
- Set the hub name, header title, and header logo.
- Apply your brand colors, or infer them from a website — give AI Mode a URL and it reads the brand's palette and applies it.
- Set section backgrounds, including background images.

**Grounding**
- **Web search** — find real facts about a company, competitor, or product to ground the copy.
- **Learn from a URL** — paste a link and AI Mode reads the page for this conversation only. It does not change your account's saved AI context; that is set explicitly in the AI settings.
- **Knowledge base** — AI Mode can look up Walnut help articles when it needs product detail.
- **Generate an image** from a description when nothing in the Resource Hub fits.

:::tip
Advanced playlists with pages (QBR and Product Gallery layouts) can be managed by AI Mode too — adding, renaming, reordering, and hiding pages, or moving a section to a different page. See [Add pages and in-hub search](/help/playlists/pages-and-search).
:::

---

## **Interactive widgets**

Your buyer asks for an ROI calculator. Historically that's a ticket, an engineer and three weeks — and it lands after the deal has moved on.

Now you describe it and AI Mode builds it: a real, working app living inside your playlist.

- **Vibe-code it, don't build it.** "Add an ROI calculator with headcount, hourly cost and hours saved." No HTML, no CSS, no JavaScript.
- **A real app, not a picture of one.** Inputs respond, numbers recalculate, tiers compare. Your buyer actually uses it.
- **Whatever the deal needs.** Comparison table, pricing configurator, readiness assessment, ROI model.
- **Refine it by talking.** "Add a payback row." "Make the CTA blue." Same widget, updated in place — never a second copy.
- **On brand, on page.** It picks up your playlist's colors and renders frameless, so it reads as part of the hub rather than an embed bolted on.

Build the experience you want, in the time it takes to describe it.

:::note
Interactive widgets are rolling out gradually and are off by default. If AI Mode says it can't build one, the capability isn't enabled for your account yet — ask your Walnut Customer Success Manager.
:::

**What actually happens**

1. **You ask.** "Add an ROI savings calculator with three inputs and a monthly total."
2. **AI Mode asks you two or three things** — which inputs, which headline metric, what visual style, what real numbers — so it builds a considered spec rather than the first literal reading of your prompt.
3. **It recommends placement.** It reads the current structure and proposes which page and position the widget should land on.
4. **You review it on the canvas.** The widget renders live in a full-width section, sized to fit its content, and you keep or undo it like any other change.

**Security**

AI-authored widgets run under a stricter sandbox than embeds you paste in yourself: no network requests, no access to cookies or browser storage, no third-party resources, and no form submission. They are purely client-side. Embeds you add by hand keep their existing behavior, unchanged.

If you want the framed look instead of the default frameless one, turn on **Show browser frame** in the section's style panel — or just ask AI Mode to do it.

---

## **Keep or undo**

When a run finishes, AI Mode posts a **result card**:

- A **N changes** row — expand it to see every individual change, jump to it on the canvas, or revert just that one.
- **Keep** — finalize the run. The card stays in the thread with a **Done** pill.
- **Undo** — revert that run's edits in one click. Other runs in the same conversation are untouched.

Undo is blocked only when a later change overlaps the same content — AI Mode tells you rather than silently reverting something you meant to keep.

---

## **Steering a run**

- **Keep typing** while the agent works. Mid-run prompts feed into the current run.
- **Stop** — the stop button sits next to send while a run is in progress.
- **Attach** a file — images, video, PDFs, Office documents, and audio — to give AI Mode something concrete to work from.
- **Questions and confirmations** — AI Mode asks rather than guesses. Clarifying questions come with suggested answers you can click, and anything destructive asks for a yes/no confirmation first.
- **To finish, please add** — if a run needs something only you have (a specific deck, a dashboard screenshot, an asset that isn't in the library), AI Mode leaves a checklist of asks instead of inventing a placeholder.

---

## **Conversations and credits**

- **Previous chats** (clock icon) — reopen an earlier conversation on this playlist.
- **New chat** (**+**) — start fresh. Threads are named automatically.
- The credit chip in the panel header shows your remaining AI credits. Usage is metered as **Playlists** in the [AI Control Center](/help/account/ai-control-center).

---

## **Good to know**

- The **header and footer are locked** structural sections. AI Mode can change the header's title and logo, but it cannot add or remove those sections.
- **Changing the layout replaces the existing sections and content** with that layout's defaults. AI Mode confirms before doing it.
- Videos must be YouTube, Vimeo, or Walnut-hosted URLs. YouTube Shorts links are refused.
- AI Mode edits the playlist you have open. It does not publish or share it — that stays your call.

---

## **FAQs**

**Do I have to approve a plan every time?**
No. Only from-scratch builds and overhauls get a plan card. Small asks just apply, and you keep or undo them.

**Can I stop a run halfway through?**
Yes. Press stop. Everything already applied stays on the canvas, and the result card still offers **Undo**.

**Does AI Mode learn from what I type?**
Not automatically. A URL you paste grounds that conversation only. Account-level AI context is set deliberately in your AI settings.

**Can it work on a playlist that already has content?**
Yes — that is the common case. On a populated hub AI Mode leads with personalization asks ("personalize this for a specific customer") rather than blank-slate builds.

---

## **Related Resources**

- [Build a deal room with AI Mode](/help/deal-rooms/ai-mode)
- [Advanced playlists](/help/playlists/advanced)
- [Add pages and in-hub search](/help/playlists/pages-and-search)
- [AI Control Center](/help/account/ai-control-center)
- [Write effective AI Mode prompts](/help/demos/edit/ai-mode/ai-prompt-guide)