# Feedback (/feedback)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 980 · updated: 2026-07-28 -->
Related: [Welcome to Bun](/index.md), [Installation](/installation.md), [Quickstart](/quickstart.md), [TypeScript](/typescript.md), [TypeScript 6 and 7](/typescript-6.md), [Convert a Node.js Readable to an ArrayBuffer](/guides/streams/node-readable-to-arraybuffer.md)

Here's how to open a helpful issue for a bug, a performance problem, or a feature request:

<Callout icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M8 7L16 7&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M8 11L12 11&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M13 21.5V21C13 18.1716 13 16.7574 13.8787 15.8787C14.7574 15 16.1716 15 19 15H19.5M20 13.3431V10C20 6.22876 20 4.34315 18.8284 3.17157C17.6569 2 15.7712 2 12 2C8.22877 2 6.34315 2 5.17157 3.17157C4 4.34314 4 6.22876 4 10L4 14.5442C4 17.7892 4 19.4117 4.88607 20.5107C5.06508 20.7327 5.26731 20.9349 5.48933 21.1139C6.58831 22 8.21082 22 11.4558 22C12.1614 22 12.5141 22 12.8372 21.886C12.9044 21.8623 12.9702 21.835 13.0345 21.8043C13.3436 21.6564 13.593 21.407 14.0919 20.9081L18.8284 16.1716C19.4065 15.5935 19.6955 15.3045 19.8478 14.9369C20 14.5694 20 14.1606 20 13.3431Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>">
  For general questions, join the 

  [Discord](https://bun.com/discord)

  .
</Callout>

## Reporting Issues [#reporting-issues]

<Steps>
  <Step title="Upgrade Bun">
    Upgrade Bun to the latest version with `bun upgrade`. This might fix your problem without opening an issue.

    ```bash icon="terminal" title="terminal" terminal
    bun upgrade
    ```

    You can also try the latest canary release, which includes changes and bug fixes that haven't reached a stable release yet.

    ```bash icon="terminal" title="terminal" terminal
    bun upgrade --canary

    # To revert to the stable release
    bun upgrade --stable
    ```

    If the issue persists after upgrading, continue to the next step.
  </Step>

  <Step title="Review Existing Issues">
    Check whether the issue has already been reported before opening a new one. It saves time for everyone and helps us focus on fixing things.

    * 🔍 [**Search existing issues**](https://github.com/oven-sh/bun/issues)
    * 💬 [**Check discussions**](https://github.com/oven-sh/bun/discussions)

    If you find a related issue, add a 👍 reaction or comment with extra details instead of opening a new one.
  </Step>

  <Step title="Report the Issue">
    If no one has reported the issue, open a new one or suggest an improvement.

    * 🐞 [**Report a Bug**](https://github.com/oven-sh/bun/issues/new?template=2-bug-report.yml)
    * ⚡ [**Suggest an Improvement**](https://github.com/oven-sh/bun/issues/new?template=4-feature-request.yml)

    Provide as much detail as possible, including:

    * A clear and concise title
    * A code example or steps to reproduce the issue
    * The version of Bun you are using (run `bun --version`)
    * A description of the issue (what you expected to happen and what actually happened)
    * The operating system and version you are using
      <Note>
        * For macOS and Linux: copy the output of `uname -mprs`
        * For Windows: copy the output of this command in the PowerShell console:
          `"$([Environment]::OSVersion | ForEach-Object VersionString) $(if ([Environment]::Is64BitOperatingSystem) { "x64" } else { "x86" })"`
      </Note>
  </Step>
</Steps>

The Bun team will review the issue and get back to you as soon as possible.

***

## Use `bun feedback` [#use-bun-feedback]

`bun feedback` sends feedback, bug reports, and feature requests directly to the Bun team.

```bash icon="terminal" title="terminal" terminal
bun feedback "Love the new release!"
bun feedback report.txt details.log
echo "please document X" | bun feedback --email you@example.com
```

Pass feedback as text arguments, file paths, or piped input.