Skip to main content

Capturing a HAR File for Bug Reporting

When reporting a bug, a HAR file helps the development team diagnose what went wrong. Learn what a HAR file is, how to capture one in your browser, and best practices for reporting defects effectively.

Written by Kristi Carlson

๐Ÿ“ Overview

A HAR (HTTP Archive) file is a recording of all network activity that takes place in your browser during a specific session. When you encounter a bug or unexpected behavior in the platform, capturing a HAR file while reproducing the issue gives our development team the data they need to diagnose and resolve it faster.

This article covers the following:

  1. Reporting a Defect or Bug

  2. Capturing a HAR File

  3. Sending Your HAR File

  4. Privacy & Security

โœ๏ธ Note: You may be asked by a support agent to provide a HAR file when submitting a bug report. Following the steps in this article proactively when you first notice an issue can significantly speed up the resolution process.


๐Ÿ“ Reporting a Defect or Bug

When you encounter unexpected behavior, the quality of information you provide directly impacts how quickly the issue can be resolved. Before capturing a HAR file, review these best practices.

Click the arrow to learn best practices for reporting a defect

๐Ÿ—‚๏ธ What to Do Before You Start

Before capturing anything, have the following ready:

  • The URL of the page where the issue is occurring (copy it from your browser's address bar)

  • A clear, repeatable way to trigger the issue

  • Notes on when the issue started and whether it is consistent or intermittent

๐Ÿ“‹ What to Include in Your Report

When submitting a bug report to support, include:

  • A screen recording or Loom video - Record yourself reproducing the issue. This gives the team visual context that screenshots alone cannot provide. Make sure the browser's address bar is visible in the recording so the URL is captured.

  • Screenshots - Take screenshots of any error messages, unexpected behavior, or the state of the page before and after the issue occurs. Always ensure the URL is visible in the address bar of any screenshot.

  • A HAR file - Follow the steps in the Capturing a HAR File section below to record network activity while reproducing the issue.

  • Steps to reproduce - List the exact steps you took before the issue occurred so the team can replicate it consistently.

๐Ÿ’ก Additional Info: The more specific and complete your report, the less back-and-forth is needed. A Loom or screen recording combined with a HAR file is the most effective way to help the team identify and fix a bug quickly.


๐ŸŒ Capturing a HAR File

Select the browser you are using below and follow the steps to capture a HAR file while reproducing the issue.

โš ๏ธ Important Note: Keep the Developer Tools panel open the entire time you reproduce the issue. Closing the panel will stop the recording.

๐Ÿ”ต Google Chrome

Click the arrow to learn how to capture a HAR file in Google Chrome

  1. Open Chrome and navigate to the page where the issue occurs.

  2. Select the three-dot menu (โ‹ฎ) in the upper-right corner of the browser window.

  3. Select More Tools, then select Developer Tools. The Developer Tools panel will open.

  4. Select the Network tab from the panel.

  5. Check the Preserve Log box to ensure network activity is not cleared when the page reloads.

  6. Confirm the record button (a circle icon in the upper-left of the Network tab) is red. If it appears grey, select it once to begin recording.

  7. Select the Clear button (a crossed circle icon) to remove any existing logs from the panel.

  8. Reproduce the issue in the browser while keeping the Network tab open.

  9. Once the issue has occurred, right-click anywhere in the network request list and select Save All as HAR with Content. Alternatively, select the Export HAR download icon in the toolbar.

  10. Save the file to your computer in a location you can easily find.

๐ŸŸ  Mozilla Firefox

Click the arrow to learn how to capture a HAR file in Mozilla Firefox

  1. Open Firefox and navigate to the page where the issue occurs.

  2. Select the Firefox menu (โ‰ก) in the upper-right corner of the browser window.

  3. Select More Tools, then select Web Developer Tools. The Developer Tools panel will open.

  4. Select the Network tab from the panel.

  5. Select the gear icon in the upper-right corner of the Network tab and check Persist Logs to ensure network activity is not cleared on page reload.

  6. Reproduce the issue in the browser while keeping the Network tab open.

  7. Once the issue has occurred, right-click anywhere within the network request list and select Save All As HAR.

  8. Save the file to your computer in a location you can easily find.

๐Ÿ”ท Microsoft Edge

Click the arrow to learn how to capture a HAR file in Microsoft Edge

  1. Open the Edge browser and navigate to the page where the issue occurs.

  2. Select the three-dot menu (โ‹ฏ) in the upper-right corner of the browser window.

  3. Select More Tools, then select Developer Tools. The Developer Tools panel will open.

  4. Select the Network tab from the panel.

  5. Check the Preserve Log box to ensure network activity is not cleared on page reload.

  6. Confirm the record button is red. If it appears grey, select it once to begin recording.

  7. Select the Clear button to remove any existing logs from the panel.

  8. Reproduce the issue in the browser while keeping the Network tab open.

  9. Once the issue has occurred, right-click anywhere in the network request list and select Save All as HAR with Content.

  10. Save the file to your computer in a location you can easily find.

๐ŸŽ Apple Safari

Click the arrow to learn how to capture a HAR file in Apple Safari

โš ๏ธ Important Note: The Develop menu must be enabled in Safari before you can access Developer Tools. If you do not see it in your menu bar, follow the steps below to enable it first.

โš™๏ธ Enabling the Develop Menu

  1. Open Safari and select Safari in the top menu bar.

  2. Select Settings, then select the Advanced tab.

  3. Check the box next to Show features for web developers.

  4. Close Settings.

๐Ÿ“ก Capturing a HAR File

  1. In the menu bar, select Develop, then select Show Web Inspector. The Web Inspector panel will open.

  2. Select the Network tab from the panel.

  3. Select the more icon (a circle icon with three lines) in the toolbar below the Network tab and check Preserve Log to ensure network activity is not cleared on page reload.

  4. Reproduce the issue in the browser while keeping the Network tab open.

  5. Once the issue has occurred, select the Export icon in the upper-right area of the Network tab.

  6. Save the file to your computer in a location you can easily find.


๐Ÿ“ค Sending Your HAR File

Click the arrow to learn how to send your HAR file to the support team

๐Ÿ—œ๏ธ Prepare the File

  • Compress the file before sending - HAR files can be large. Zip or compress the file before attaching it to keep it within size limits.

  • Rename the file - By default, HAR files are named after the page URL. Rename the file to something descriptive (for example: login-error-april2026.har.zip) so it is easy to identify and does not trigger spam filters.

๐Ÿ“Ž Attach to Your Ticket

  • Attach to your support ticket - Upload the compressed HAR file directly to your open support ticket. If the file exceeds attachment limits, share it via a file-sharing service such as Google Drive or Dropbox and include the link in your ticket.


๐Ÿ”’ Privacy & Security

Click the arrow to learn about what data is included in a HAR file

๐Ÿ—ƒ๏ธ What HAR Files Contain

HAR files capture all network activity during the recording session, which may include sensitive information such as:

  • Session tokens and cookies

  • Form data submitted during the recording

  • URLs of pages visited

โš ๏ธ Important Note: Only share HAR files with trusted parties such as the Dash support team. Do not share HAR files publicly or with anyone outside of the support process.

๐Ÿงน Removing Sensitive Data: If you are concerned about sensitive data in your HAR file, you can use the Cloudflare HAR Sanitizer here to remove sensitive values before sending.

๐Ÿ’ก Additional Info: For more ways to get help, including chat, email, and the Ticket Portal, visit the Dash Support Options article below.

Did this answer your question?