Bug submission tips

We rely on bug reports to improve our product! This article covers tips for screen recording and generating HAR files.

Screen recording apps

Here are some screen recording apps you can quickly set up:

Clip

  • Use our built-in screen recording tool, Clip.

  • An owner or admin must activate the Clip ClickApp. 

Loom

  • Supported by all browsers

  • Share videos publicly or privately

  • Free version

Cleanshot

  • Only supported for Mac

  • Can take GIFs, videos, and screenshots

Screenshot shortcuts

Here are the screenshot shortcuts for different operating systems:

Android 

  • Hold the power and volume down buttons at the same time for a brief second to save a screenshot.

iOS 

  • Hold the home and power buttons at the same time for a brief second to save a screenshot.

Windows

  • Copy full-screen screenshot to the clipboard: PrtScn

  • Save full-screen screenshot: Windows Key + PrtScn

  • Copy screenshot of single window: Alt + PrtScn

  • Save screenshot of a single window: Windows Key + Alt + PrtScn

Mac

  • Save fullscreen screenshot: Command + Shift + 3

  • Save screenshot of a single window: Command + Shift + 4

  • Save screenshot of selection: Command + Shift + 4

Ubuntu

  • Full-screen screenshot: PrtScn

  • Screenshot of the current window: Alt + PrtScn

  • Screenshot of selection: Shift + PrtScn

Generate a HAR file

ClickUp Technical Support may occasionally need additional logs for our Development team when investigating a bug. We may ask you to record a HAR file, or a log of network requests, while that issue occurs.

A HAR file may include personal data. Cloudflare has released a HAR sanitizer.

Instructions for generating a HAR file will vary based on your browser:

  • Google Chrome
  • Firefox
  • Brave
  • Windows Desktop App

Generate a HAR file in Google Chrome

To generate a HAR file in Google Chrome:

  1. Open Chrome's Developer Tools by selecting View, Developer, then Developer Tools.
  2. In the Developer Tools window:
    • Verify that the record button in the upper-left corner is red. If it is grey, click the button once to start recording.
    • Check the Preserve log box.
    • Clear both the Network and Console tabs by clicking the Clear icon.
  3. Reproduce the bug and wait for the logs to finish loading. This should take no longer than one minute.
  4. Save the HAR file by clicking the Download icon.Screenshot of saving the HAR file by clicking Download.

Generate a HAR file in Firefox

  1. From Firefox, select Tools, Browser Tools, and then Web Developer Tools.
  2. From the Developer Tools window:
    • Ensure that the Network tab is unpaused.
    • Ensure that the Persist Logs option is checked in the settings menu
    • Clear both the Network and Console tabs by clicking the Trash icon.
  3. Reproduce the bug and wait for the logs to finish loading. This should take no longer than one minute.
  4. Save the HAR file by clicking the Save All as HAR option in the settings menu.

Generate a HAR file in Brave

  1. From Brave, select View, Developer, then Developer Tools.
  2. In the Developer Tools window:
    • Ensure that the Network tab is unpaused.
    • Ensure that the Preserve Log option is checked.
    • Clear both the Network and Console tabs by clicking the Clear icon.
  3. Reproduce the bug and wait for the logs to finish loading. This should take no longer than one minute.
  4. Save the HAR file by clicking the Download icon.

Generate a HAR file in the Windows Desktop App

  1. From the Desktop App, select View and then Toggle Developer Tools.
  2. In the Developer Tools window:
    • Ensure that the Network tab is unpaused.
    • Ensure that the Preserve Log option is checked.
    • Clear both the Network and Console tabs by clicking the Clear icon.
  3. Reproduce the bug and wait for the logs to finish loading. This should take no longer than one minute.
  4. You can save the HAR file by clicking the Download icon.

Generate WebSockets logs

ClickUp Technical Support may also ask for WebSockets logs when investigating a bug. 

To generate and save a WebSockets log:

  1. First, open Chrome's Developer Tools.
  2. With the Developer Tools window open, refresh the page. Chrome Developer Tools must first be reloaded for the logs to be captured correctly.
  3. Ensure that the Network tab is selected and recording.
  4. Open the WS tab.
  5. Ensure that at least one GraphQL item is shown in the list. It may take up to seven seconds to load. If it doesn't load, try refreshing the page.
  6. Wait for the logs to finish loading. This should take no longer than one minute.
  7. Save the WebSockets log file by clicking the download icon.
  8. Name the file WS.har. A WebSockets log may include personal data, but you can use Cloudflare's sanitizer to remove it.
  9. In your email thread with ClickUp Technical Support, attach your file.
    •