Write prompts for Appcues AI
Use mentions and file attachments to give Appcues AI context.
Table of Contents
The prompt editor is where you talk to Appcues AI in the Appcues App. You type what you want in plain language, and you can reference specific campaigns, experiences, or segments with @-mentions and attach files for Appcues AI to use.
The Appcues App is in beta and rolling out gradually. If you don't see it yet at app.appcues.com, it hasn't been enabled for your account. See Introducing the Appcues App for more.
What you can ask Appcues AI
Appcues AI can do more than answer questions. You can ask it to:
- Create and organize campaigns — set up a campaign, add tactics, and group experiences. See Create a campaign.
- Answer questions about your data — ask how a campaign is performing or why users are dropping off.
- Help you act on recommendations — talk through a recommendation and apply it. See Review and act on recommendations.
- Build experiences — create an experience from a description. See Create an experience with Appcues AI.
Where you'll find it
The same prompt editor appears in three places, and works the same way in each:
- Home page — the large prompt at the center of the Home page. Submitting starts a new conversation.
- A conversation — the input at the bottom of any open chat.
- The chat panel — a side panel you can open from any page to ask for help in context.
Write a prompt
Type your request in plain language and press Enter to send. Use Shift + Enter to add a line break without sending.
Some examples of what you can ask:
- "Create a new campaign to lift activation amongst new signups"
- "How is my most recently updated campaign performing this quarter?"
- "Why are operators dropping off after their first week?"
- "Build me a tactic to re-engage at-risk accounts"
The send button is disabled while the input is empty or while a file is still uploading. While Appcues AI is replying, the send button becomes a Stop button so you can interrupt it.
Reference things with @-mentions
To point Appcues AI at something specific, type @ (or click the @ button) and start typing its name. A list of matches appears — use the arrow keys and Enter (or click) to insert one.
You can mention:
- Campaigns and Tactics
- Experiences of any type
- Workflows
- Segments
- Key Actions
A confirmed mention shows as a chip in your prompt. Mentioning something gives Appcues AI that exact item as context — for example, "@Campaign: Trial Activation" tells Appcues AI which campaign you mean, including its brief.
Attach files
You can attach files for Appcues AI to read — for example, a PDF brief or a CSV of data.
- Click the + button and choose files, or
- Drag and drop files onto the prompt, or
- Paste an image (such as a screenshot) directly into the prompt.
Each attachment appears as a chip showing the file name and type (images show a thumbnail). Hover a chip and click the X to remove it.
Limits:
- Up to 5 attachments per message
- Up to 10 MB per file
- Supported files: images (JPEG, PNG, GIF, WebP), documents (PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, RTF, ODT, CSV), text and markdown, and common code/data files (JSON, JS, TS, SQL, YAML, and similar)
If a file is too large, unsupported, or would exceed the 5-file limit, the editor tells you and skips it. Wait for uploads to finish before sending.
What to attach and why
Attachments let Appcues AI work from your real source material instead of a description you retype. Useful things to attach:
- A brief or PRD — attach the launch doc, one-pager, or spec and ask Appcues AI to build a campaign from it. It pulls the details straight from the source instead of your paraphrase.
- A screenshot — paste a screenshot of the page, feature, or an existing message so Appcues AI can see what you're referring to instead of describing it in words.
- Existing copy or a voice guide — attach past campaign copy or a tone-and-style doc so the messaging Appcues AI drafts sounds like your brand.
- A CSV of data — attach a cohort export or usage data to ground audience and targeting decisions in real numbers.
- Event or property references — attach a file (such as JSON) listing your event names or properties so Appcues AI works from the exact keys your product sends.
Attachments are context, not commands. Appcues AI reads them to understand what you want — it still works through the outcome, audience, and timing with you before it builds anything.
Get better results from Appcues AI
Appcues AI works best when you describe the outcome first and let it choose the experience. Here's why, and how to apply it.
Start with the problem
Instead of naming the experience you want, describe the problem: "New users aren't completing setup — I want to guide them through the three required steps on their first login." Appcues AI uses your goal and audience to pick the right experience, sequencing, and targeting. When you prescribe the experience upfront, you skip the diagnosis that makes the recommendation good.
Name your audience
"New users" is a start, but Appcues AI gives sharper results when you describe the segment: "Users who signed up in the last 7 days and haven't completed the setup wizard." Behavioral descriptions (what the user has or hasn't done) are more useful than attribute-only descriptions (what plan they're on), because they tell Appcues AI where the user is in their journey, not just who they are.
Give context on the product
If the action spans multiple pages, mention that. If there's a prerequisite step (like connecting an integration before using a feature), mention that too. The more Appcues AI knows about how your product works, the better it sequences the experience.
Describe the moment, not just the message
Tell Appcues AI when this should appear — "when the user first lands on the dashboard" or "after they've used the feature three times but haven't tried the advanced settings." Timing and targeting are as important as the content itself.
One ask at a time
Break large campaigns into separate requests. Ask Appcues AI to build the welcome message first, review it, then ask for the follow-up. You'll get better results from a series of focused prompts than from a single long request that tries to cover an entire campaign.
Manage your conversations
Your conversations are saved in the left sidebar, grouped by date. Hover a conversation to rename or delete it.
Appcues AI also remembers context across conversations, so you can pick up where you left off without repeating yourself. To see or clear what it remembers about you, go to Settings > Appcues AI and use Your AI Memory > Clear memory.
Notes
- The prompt editor is plain text plus mentions — there are no rich-text formatting controls or slash commands.
- Pasting a web address adds it as plain text; there's no separate URL attachment.