diff --git a/docs/platforms/javascript/guides/hono/features/error-handler.mdx b/docs/platforms/javascript/guides/hono/features/error-handler.mdx
new file mode 100644
index 0000000000000..9167f06300b59
--- /dev/null
+++ b/docs/platforms/javascript/guides/hono/features/error-handler.mdx
@@ -0,0 +1,102 @@
+---
+title: Error Handler
+description: "Learn how Sentry's Hono SDK captures errors and how to customize which errors are sent to Sentry."
+---
+
+The `sentry()` middleware automatically captures unhandled errors from Hono's `onError` handler.
+
+## Default Behavior
+
+The default logic checks whether the error carries a numeric `status` property (as Hono's `HTTPException` and similar error types do).
+
+The middleware captures:
+
+- **5xx errors** — anything with a numeric `status >= 500`
+- **Non-HTTP errors** — errors without a numeric `status` property, including standard `Error` instances, non-object throws, and `null`
+
+The middleware ignores:
+
+- **3xx–4xx errors** — anything with a numeric `status` in the range 300–499 (redirects, client errors)
+
+Use `shouldHandleError` when you need to capture errors outside this default range, for example to track 401 and 403 responses as security signals.
+
+## Using `shouldHandleError`
+
+Pass a `shouldHandleError` callback to the `sentry()` middleware. The callback receives the raw error as `unknown` and must return `true` to capture it or `false` to suppress it.
+
+```typescript {tabTitle:Cloudflare Workers} {filename:index.ts} {mdExpandTabs}
+import { Hono } from "hono";
+import { sentry } from "@sentry/hono/cloudflare";
+
+const app = new Hono();
+
+app.use(
+ sentry(app, {
+ dsn: "___PUBLIC_DSN___",
+ shouldHandleError(error) {
+ const status = (error as { status?: number })?.status;
+ // Capture 401/403 in addition to the default 5xx errors
+ return (
+ status === 401 ||
+ status === 403 ||
+ typeof status !== "number" ||
+ status >= 500
+ );
+ },
+ })
+);
+
+export default app;
+```
+
+```typescript {tabTitle:Node.js} {filename:app.ts}
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { sentry } from "@sentry/hono/node";
+
+const app = new Hono();
+
+app.use(
+ sentry(app, {
+ shouldHandleError(error) {
+ const status = (error as { status?: number })?.status;
+ // Capture 401/403 in addition to the default 5xx errors
+ return (
+ status === 401 ||
+ status === 403 ||
+ typeof status !== "number" ||
+ status >= 500
+ );
+ },
+ })
+);
+
+// Your routes here
+
+serve(app);
+```
+
+```typescript {tabTitle:Bun} {filename:index.ts}
+import { Hono } from "hono";
+import { sentry } from "@sentry/hono/bun";
+
+const app = new Hono();
+
+app.use(
+ sentry(app, {
+ dsn: "___PUBLIC_DSN___",
+ shouldHandleError(error) {
+ const status = (error as { status?: number })?.status;
+ // Capture 401/403 in addition to the default 5xx errors
+ return (
+ status === 401 ||
+ status === 403 ||
+ typeof status !== "number" ||
+ status >= 500
+ );
+ },
+ })
+);
+
+export default app;
+```
diff --git a/docs/platforms/javascript/guides/hono/features/index.mdx b/docs/platforms/javascript/guides/hono/features/index.mdx
new file mode 100644
index 0000000000000..0580f8f8c3f5d
--- /dev/null
+++ b/docs/platforms/javascript/guides/hono/features/index.mdx
@@ -0,0 +1,9 @@
+---
+title: Hono Features
+description: "Learn how Sentry's Hono SDK exposes features for first-class integration with Hono."
+excerpt: ""
+---
+
+The Sentry Hono SDK offers Hono-specific features for first-class integration with the framework.
+
+
diff --git a/docs/platforms/javascript/guides/hono/index.mdx b/docs/platforms/javascript/guides/hono/index.mdx
index aee4767784aca..86fff01274834 100644
--- a/docs/platforms/javascript/guides/hono/index.mdx
+++ b/docs/platforms/javascript/guides/hono/index.mdx
@@ -363,6 +363,8 @@ export default app;
By default, Sentry captures exceptions from Hono's `onError` handler, excluding errors with 3xx or 4xx status codes. No additional configuration is needed for this.
+To control which errors are captured, use the `shouldHandleError` option.
+
### Add Readable Stack Traces With Source Maps (Optional)
@@ -385,6 +387,7 @@ Now's a good time to customize your setup and look into more advanced topics:
- Explore [practical guides](/guides/) on what to monitor, log, track, and investigate after setup
- Learn how to manually capture errors
+- Explore Hono-specific features like custom error filtering
- Continue to customize your configuration
- Get familiar with [Sentry's product features](/product) like tracing, insights, and alerts