How to create a short browser bug reproduction video
Record a clear browser bug reproduction with the steps, expected and actual results, and useful context, while keeping private details out of the video.
A short video can make a browser bug easier to understand than a written description, especially when the problem depends on a particular click or sequence of steps. The clearest recording shows the starting point, the exact action that triggers the problem, and what happens instead.
You can capture a browser tab, window, or screen with the Screen Recorder. Plan the steps first, record only the relevant area, then check the saved video for clarity and private information before sending it.
Record a clear bug reproduction
- Open the Screen Recorder on a computer. It does not work on phones. Decide which browser page and steps you need to show before you start recording.
- Choose whether to share a browser tab, a window, or the full screen in the browser's sharing prompt. Share the smallest area that shows the problem. If the page needs sound, choose a sound-sharing option if one is offered.
- Start from a useful state, such as the page before you click the control that fails. Pause briefly so the viewer can see where you are, then perform the steps in their normal order.
- Show the result and wait a moment before stopping. If the bug is intermittent, make another attempt only if it is useful to show the failure. Avoid repeatedly clicking so quickly that the viewer cannot follow.
- Review the recording from beginning to end. Check that the important action and result are visible, the video has the sound you intended, and no private information appears. Save a copy with a descriptive file name.
The recording should be only as long as it needs to be. A brief lead-in and a few seconds after the result help explain the context, but recording unrelated browsing makes the problem harder to spot.
Include the details someone needs to reproduce it
A useful bug video answers three questions: what were you trying to do, what did you expect, and what happened instead? You can explain these in a short voiceover or add them in the message that accompanies the video. Keep the narration factual, and distinguish what you expected from what you actually saw.
- Starting point. Show the page or browser state before the problem occurs. If you had to sign in or change a setting, describe that step without exposing credentials.
- Exact actions. Move the pointer deliberately and click the relevant controls in order. If typing matters, enter harmless sample text rather than real personal or business data.
- Expected result. Say briefly what you thought would happen, such as a page opening or a file appearing.
- Actual result. Keep the unexpected behavior on screen long enough to see it. If an error message appears, leave it visible without obscuring it with another window.
- Useful context. Mention the browser and operating system in the accompanying report if they may matter. Avoid showing unrelated settings, other open tabs, or notifications just to provide background.
Do not assume that a viewer can infer the sequence from the final error alone. A small pause before each important action can make the recording much easier to follow.
Choose what to record and whether to use audio
Record a browser tab
Choose a tab when the bug happens on one page and the page itself provides enough context. This keeps other tabs and desktop content out of view. If the browser offers tab audio sharing, enable it only when sound is part of the bug.
Record a window
A window can be a better choice when the problem involves browser controls or a page interacting with another app. Close unrelated windows first, and make sure the relevant content remains visible throughout the reproduction.
Record the full screen
Use the full screen only when the bug crosses between windows or depends on a system prompt. Close private documents and messages, turn off notification previews if needed, and check what is visible before sharing the screen.
Add microphone or camera
A short voice explanation can clarify a step, but it is not necessary if the actions are easy to follow. A camera view is usually unnecessary for a browser bug report. Every tool that uses a camera or microphone asks for permission first. If microphone access is blocked, check Settings › Privacy & security › Microphone in Windows 11 or System Settings › Privacy & Security › Microphone on macOS.
Keep private information out of the video
Before recording, close pages that contain personal or confidential information. Watch for email addresses, names, account details, private messages, file names, and URLs that include tokens or other sensitive values. A screen recording can reveal more than the bug itself, including browser bookmarks, notifications, and open tabs.
Review the entire saved video before sending it, including the first and last few seconds. If the recording includes information that should not be shared, make a new recording with a safer setup rather than relying on the recipient to ignore it. The Screen Recorder works with the recording on your device, and the recording is not uploaded by the tool.
Fix common recording problems
The browser does not offer the screen or window you need
Check that you opened the sharing prompt from the Screen Recorder and that the intended tab or window is open. On a Mac, review System Settings › Privacy & Security › Screen & System Audio Recording if screen capture is blocked, then allow the browser and try again. Managed computers may have screen sharing restricted by an administrator.
The video is blank or shows the wrong area
Stop and start a new recording, then select the correct tab, window, or screen in the browser prompt. Some protected video content cannot be captured normally, so do not use a protected stream as the test case.
The recording has no sound
Decide whether you need the page's sound, your microphone, or both. Check the source selection and any sound-sharing option in the browser prompt, and make sure the microphone is not muted. On Windows 11, check Settings › System › Sound for the selected input. On macOS, check System Settings › Sound › Input.
When you send the video, include a sentence naming the browser and operating system, then list the steps in order. That gives the recipient a clear path to try without making the recording longer than it needs to be.
