How to record a Figma prototype on a Mac
Figma can't export a prototype as a video. You have to screen-record it. The tricky parts are the ones Figma's forum keeps asking about: the blue hotspot flashes, the Figma toolbar, a hand cursor that shows up over every clickable area, and a desktop arrow pointer moving around on a phone design. Here's how to get a clean recording on a Mac, then turn it into an MP4 or a GIF that won't slow down your portfolio.
Prepare the prototype for recording
Open the prototype in presentation view in your browser, not inside the Figma editor. Then add two settings to the end of the prototype link:
&hide-ui=1&hotspot-hints=0
hide-ui=1hides Figma's interface around the prototype. It's the same as choosing to hide the UI in presentation view.hotspot-hints=0stops the blue flash that marks clickable areas when you click somewhere that isn't one.
Two more things before you record:
- Set the background colour. In the prototype settings, choose a background that matches your portfolio. Whatever is around the frame ends up in the recording, so pick it on purpose.
- Click through once. Images and fonts load on the first visit to each screen. Do one dry run so nothing pops in while you record.
One known gap: people report that hiding hotspot hints doesn't work in Figma's mobile mirror. Record from the desktop browser instead.
The cursor problem
This is where most prototype recordings look off. Three common complaints on Figma's forum:
- The cursor never goes away. People have asked Figma for a way to turn it off during playback, for usability tests as much as for videos.
- The hand cursor shows up over clickable areas, even with hotspot hints turned off. It gives away where every link is.
- A desktop arrow on a phone design looks wrong. Nobody uses a mouse pointer on a phone.
Figma can't fix this, so the fix has to come from the screen recorder. You have three options:
- Hide the cursor completely. Works for slow, story-like walkthroughs where the screens speak for themselves.
- Use a touch indicator. A soft circle where you "tap" is the closest thing to a real finger, and the right choice for mobile prototypes.
- Keep the arrow, but smooth it. For desktop and web prototypes. Move it slowly and deliberately. Twitchy mouse movement reads as nervous.
Record it
- Record the browser window, not the whole screen. No Dock, no menu bar, no other tabs.
- Turn on a Focus mode so no notification slides in.
- Pace it like a person would. Pause on each screen long enough to read it, about a second or two longer than feels natural while you record.
- Keep it short. One flow per video: sign-up, checkout, one feature. 15 to 30 seconds is plenty for a portfolio.
Export: MP4 beats GIF
People search for how to record a Figma prototype "as a GIF" a lot, and GIFs are easy to drop anywhere. But they're heavy. On an 8-second test clip I converted both ways, a GIF at half the width and half the frame rate was still 1.7 times bigger than the MP4 (2.9 MB vs 1.7 MB). Portfolio advice is consistent on this: a heavy hero video costs you visitors when a recruiter opens your site on slow office Wi-Fi.
Use MP4 wherever your site allows it. Framer, Webflow and most portfolio builders take MP4 uploads. Both commands below need ffmpeg (brew install ffmpeg), and I tested both.
Small MP4 for a portfolio
ffmpeg -i prototype.mov -vf "scale=1600:-2:flags=lanczos,fps=30,format=yuv420p" \
-c:v libx264 -preset slow -crf 26 -an -movflags +faststart prototype-web.mp4
This shrinks it to 1600 pixels wide, drops the audio and puts the file's index at the start so it begins playing before it fully downloads. Raise -crf to 28 for a smaller file, or lower it to 23 for sharper text.
If you write your own HTML, this makes it behave like a GIF: autoplay, loop, no sound, and it plays inline on iPhones:
<video src="prototype-web.mp4" autoplay muted loop playsinline></video>
GIF, when you really need one
Some places only take GIFs: Dribbble shots, GitHub READMEs, certain CMS fields. This command builds a custom colour palette first, which keeps gradients from turning into stripes:
ffmpeg -i prototype.mov -vf "fps=15,scale=800:-1:flags=lanczos,split[a][b];[a]palettegen=max_colors=128[p];[b][p]paletteuse=dither=bayer" \
-loop 0 prototype.gif
Using it in a case study
- Put it near the top. If you've built something real, move it up where people will see it, not to the end of the case study. Plenty of reviewers stop reading before they get there.
- Add a live link too. Some hiring managers want to click through the prototype themselves. The video is for everyone who won't.
- Make the story work without it. The video shows what you made. The case study still has to explain why.
The tools, honestly
QuickTime (⌘⇧5) records a window for free. You just can't do anything about the cursor: it records exactly what's on screen, hand pointer included.
I make CursorFlow, a Mac screen recorder, and the cursor problem above is one it handles. It records where you click and draws the cursor itself afterwards. So in the editor you can switch it to a touch disc, a macOS or Windows-style pointer in your colours, or hide it, without re-recording. That needs the Input Monitoring permission macOS asks for. Without it, the real cursor is recorded into the video like in QuickTime. Cursor smoothing irons out the twitchy movement. You can also add a background and padding around the window if you want the prototype to sit on your brand colour.
What it doesn't do: it records a whole display or a single window, not a custom area, and it exports MP4 or MOV, not GIF. Use the ffmpeg command above for that. It's free to use, with a watermark on exports until you buy the one-time licence.


