A product demo gets confusing pretty quickly when you're trying to show everything the product can do. You know why each screen matters, but someone watching for the first time is still working out what they're looking at.
I'd start with one thing someone wants to get done and make the video follow that task from beginning to end. AI can help you put the scenes together, but you still need to decide which actions matter and check that the finished demo shows what your product actually does. Here's a practical way to work through that.
Choose a task with a result you can show
Try writing down the question your viewer needs answered. 'How do I send a report to my team?' gives you a much clearer starting point than 'How do I show our analytics platform?' The first question tells you what needs to happen on screen, and where the demo can end.
For this guide, imagine a fictional reporting tool that lets someone choose a saved report, pick a date range, and share a link with colleagues. The demo needs to show those steps and what the recipient sees. It doesn't need to explain the dashboard builder, billing settings, or every report type.
This is a made-up workflow for explaining the process, not a claim about Impractical or a customer result. Substitute a task you've checked in your own product before making the video.
Decide whether the viewer needs an overview or instructions
Someone deciding whether to try your product needs enough detail to understand what it does for them. Someone who already uses it and needs help completing a task may need the exact navigation, button labels, and permissions. Those are different jobs, even if both videos are called demos.
For an overview, you can remove waiting time and simplify surrounding context while keeping the important action understandable. For a tutorial, explain any setup the viewer needs before they can follow along. If sharing requires a particular permission, leaving that out creates a confusing experience when they try it themselves.
Write the audience and intended next step at the top of the brief. That makes it easier to decide whether a scene belongs in the video or in a separate help article.
Screen recording or animation: choose what the viewer needs to see
A screen recording makes sense when the thing you're explaining is already visible in the interface. If someone needs to find the sharing menu and choose a permission, showing that actual interaction gives them something they can follow in their own account. Before deciding to animate it, try a rough recording of just that part and watch it at the size you expect to publish.
If the recording is hard to follow, work out why. Small controls might need a closer crop or a highlight. Unrelated tabs might need a cleaner demo account. Neither problem necessarily means you need to rebuild the screen as animation. I'd fix those distractions first, because otherwise you can spend a lot of time recreating an interface that was perfectly usable once you focused the view.
Animation becomes useful when the explanation needs something a screen recording doesn't show clearly. You might need to explain how a request moves between two systems, or keep the input and its result visible together when they live on different screens. In that case, a diagram or a carefully simplified view can help. Keep it clear which parts represent a real interface and which parts explain the idea behind it.
You can also combine the formats. Use a short diagram to explain the relationship, then switch to the recording when the viewer needs to see the actual product. The handoff needs to be understandable: use the same example names and data so it doesn't feel like you've jumped to a different task.
Before committing, ask who will update the video when the product changes. A recording can need another capture when the navigation moves; a recreated interface can need changes to the artwork and animation as well. If you're making a help video for a screen that changes often, keep that section separate enough to replace without remaking the whole explanation.
How the same reporting demo could use either format
Let's use the fictional reporting tool from earlier to make the choice more concrete. These are hypothetical treatments of that workflow, not videos we've produced or a comparison we've tested.
For someone who already has an account and wants to share a report, I'd start with a screen recording. Show the saved report, change the dates, open the sharing controls, and then show the recipient's view. The useful detail is where the controls are and what each action changes. A diagram of people sharing information wouldn't answer those questions, however polished it looked.
For someone who hasn't used the tool, you could start with a simple animation showing a report owner and a colleague looking at the same weekly report. That introduces the relationship without expecting them to understand the whole dashboard immediately. Then move into a recording of the sharing step so they can see what the product actually does. The animation sets up the explanation; the recording supplies the product detail.
There's a specific mistake to watch for in that second version. If the animation shows the report arriving in the colleague's inbox, viewers could reasonably think sharing sends an email automatically. Our fictional workflow only says the owner copies a link, so the scene should show that link being shared without inventing a delivery feature. Deciding on the format doesn't give you permission to change the workflow.
For your own demo, write down one thing the viewer must be able to recognize afterward. If it's a control they need to use, make sure the actual control gets enough time on screen. If it's a relationship between things, sketch that relationship first and decide where the real interface helps explain it. That gives you a reason for each format choice before you've spent time producing the scenes.
Capture the workflow before asking AI to explain it
Run through the task in a clean demo account and collect the screens you actually need. Use fictional names and data that you've deliberately prepared for the example, rather than taking a quick recording of a customer account and hoping nothing sensitive appears.
Keep the starting state, the action, and the result. In the reporting example, that means the saved report before the date range changes, the updated report, the sharing controls, and the page a colleague opens. An attractive final screenshot alone won't explain how someone gets there.
If you're recreating the interface in motion graphics, keep the labels and relationships faithful to the product. You can make a small control easier to see without inventing a feature. If you use a conceptual diagram instead, make that distinction clear to the viewer.
Write the script beside what happens on screen
Writing the narration on its own makes it easy to promise more than the visuals demonstrate. Put each line beside the action that supports it so you can spot where the explanation needs another scene or a more careful sentence.
For the fictional reporting tool, a short outline might look like this. The timings are planning suggestions, not a target you have to squeeze your own workflow into.
Opening: Show the saved report. Say: Here's how to share this week's report with your team. Action: Select this week's date range and let the results update. Say: Choose the dates you want your team to review. Action: Open sharing and copy the report link. Say: Copy a link to the report. Result: Open the link as a colleague with access. Say: Your team can open the report from the link. Next step: Show where to find saved reports. Say: Open a saved report to try it.
Notice that the script doesn't say the link works for everyone, updates automatically, or saves a particular amount of time. Those might be true for some products, but you'd need to verify them before putting them in this demo.
Give the agent a brief that explains what it must preserve
Tell the agent which files show the current product, what order the steps happen in, and which details cannot change. Include the intended audience and viewing context so it can make sensible choices about framing and text size.
It's also worth being explicit about missing information. Ask it to flag any screen or transition it can't explain from your assets. That is more useful than getting a smooth-looking sequence that quietly fills a gap with an invented interface.
Make a demo for existing users who want to share a weekly report. Use the supplied screenshots and recording as the source for the interface. Show the saved report, the date selection, the sharing controls, and the recipient opening the link, in that order. Keep the actual labels. Don't imply that someone without permission can open it. The video will sit inside a help article, so the controls need to be readable at the article's display size. Flag any missing step before making assumptions.
Review the result as someone who has never done the task
Watch the video once without narrating over it. Can you tell what changed after each action? If the cursor moves before you've found the relevant control, or the result disappears immediately, give that part more time rather than adding another caption to explain what the viewer missed.
Then compare the sequence against the current product. Check labels, permissions, sample data, and the state of the result. AI-generated interface details deserve the same scrutiny as the script because a believable-looking wrong button can be harder to notice than an obvious placeholder.
Finally, watch at the size it will actually appear. If the video needs audio to make sense, provide captions or a nearby written explanation for people who can't listen. Check the caption wording against the product too, especially names and abbreviations.
How this workflow fits with Impractical
Impractical gives a coding agent tools to create a video project and draft, edit the draft's source files, and request an MP4 export. The agent needs to build the scenes; creating the project itself doesn't produce a completed demo.
You can use the brief above to explain the task and then review the draft as you make changes. Keep the recording or screenshots available as a reference so that a visual revision doesn't accidentally change what the product appears to do.
Once the explanation and product details are right, export and check the actual file. A preview is useful while you're working, but the exported video is what your audience will watch.
Questions that usually come up while making a demo
Do you need a voiceover? Not necessarily. A simple workflow can work with readable labels and captions, provided someone can understand the action and result without extra explanation. Try watching without sound before deciding that it works.
How long should it be? Long enough to explain the chosen task at a readable pace. If the video keeps growing because it needs more setup, consider whether you're combining an introduction and a tutorial that would be easier to use separately.
Should you show every click? Include the steps that explain how the result happens. You can remove irrelevant waiting and navigation in a marketing overview, but don't make a multi-step process look like a capability your product doesn't have.