---
title: "Replace a content item without losing your edits"
slug: "/help/playlists/replace-content-item"
topic: "playlists"
last_updated: "2026-11-19T14:16:40.031Z"
description: "Swap a playlist or deal room item for a different demo, video, PDF, or embed with Replace. Your position, description, and custom thumbnail stay, and Cmd/Ctrl+Z undoes it."
---

Swap a content item in a playlist or deal room for something else — a different demo, video, PDF, image, Google Drive file, or embed — without rebuilding the card around it. The replacement keeps the slot the old item sat in and the edits you made to it, so a swap is one click plus (when needed) one choice.

---

## **Snapshot 📸**

**Applies to:** Advanced Playlists (Sales Hub, Customer Hub), Deal Rooms, and Choose Your Own Adventure playlists

**Where it lives:** The item's **Replace** action in the editor — from the item toolbar, the right-click menu, or AI Mode

---

## **What stays and what changes**

When you replace a content item, Walnut keeps everything that made the card yours and takes only the content from the new item.

| **Kept from the old item** | **Taken from the new item** |
| --- | --- |
| Position in the gallery, carousel, or page | Content type (demo, video, PDF, image, embed) |
| Description | Auto-generated thumbnail |
| Visibility (hidden or shown) | Duration, file size, and other content-derived fields |
| Custom thumbnail and its crop | |
| Name (when you renamed it) | |
| Any other per-item setting | |

The new content can be any type — replacing a demo with a PDF, or a video with another demo, works the same way.

The item's **name** is a special case: Walnut keeps the name you set, but if the current name is still the item's default (the demo name, the file name, or a generic fallback) it is replaced with the new content's own default name. This keeps renamed cards intact without carrying a stale default onto a different file.

---

## **Replace an item**

1. Open the playlist or deal room in the editor.
2. Select the content item you want to replace in a Gallery, Carousel, or CYOA section.
3. Click **Replace** in the item's toolbar, or right-click the item and choose **Replace**.
4. Pick the new content — a demo from your library, an upload, a URL, an embed, or a Resource Hub asset.

The new item takes the old one's place immediately and becomes the selected item.

---

## **"Keep your changes?"**

If the item you are replacing was edited — renamed, given a description, or set to a custom thumbnail — Walnut opens a **Keep your changes?** dialog before the swap so you decide what wins:

- **Keep my changes** — the new content takes the slot, keeping the title, description and thumbnail you set. This is the default.
- **Use new content's** — the slot is reset to the new content's own name, description and thumbnail, as if you had added it fresh.

An item with no edits swaps directly; the dialog does not appear.

---

## **Replace from AI Mode**

AI Mode can replace a content item for you — ask it to swap one demo for another and it uses the same path, always keeping your edits. AI replacements never prompt the dialog.

---

## **Undo a replace**

A replace is one action, so pressing **Cmd/Ctrl+Z** once brings the old item back exactly as it was — same id, same edits, same position. **Shift+Cmd/Ctrl+Z** redoes it.

---

## **Good to know**

- The replaced item gets a new identity under the hood, so any link that pointed at the old item id (for example, a direct link into that card) will no longer resolve.
- Manual translations written against the old item's description do not carry across the swap. Automatic translations come back on the next translation run.
- Replace is not available in Embedded Content sections — those sections use the standard remove-and-add flow.

---

## **FAQs**

---

**Can I replace a demo with a PDF, or a PDF with a video?**

Yes. The new content can be any type the section accepts — a swap across types works the same as a swap between items of the same type.

---

**I renamed an item. Will the rename survive the replace?**

Yes, as long as the name was something you set. If the name is still the item's default (the demo's name, the file name, or a generic label), Walnut treats it as unset and uses the new content's default name instead.

---

**Does replace work in the AI agent?**

Yes. When AI Mode swaps an item it uses the same keep-edits behaviour, and it does not prompt the dialog — the agent always keeps your edits.

---

**How do I get back the old item if I replace the wrong one?**

Press **Cmd/Ctrl+Z** once. A replace is a single action in the undo stack.

---

## **Related Resources**

[Change a section's type without losing its content](/help/playlists/change-section-type)

[Create a playlist](/help/playlists/create)

[Build a playlist with AI Mode](/help/playlists/ai-mode)
