Replace a content item without losing your edits
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.
Replace a content item without losing your edits
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​
- Open the playlist or deal room in the editor.
- Select the content item you want to replace in a Gallery, Carousel, or CYOA section.
- Click Replace in the item's toolbar, or right-click the item and choose Replace.
- 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.