Query D1 from Hono
- On this page

Query D1 from Hono

Query D1 from the Hono web framework

Last updated Apr 21, 2026 Hono is a fast web framework for building API-first applications, and it includes first-class support for both Workers and Pages.

When using Workers:

Ensure you have configured your Wrangler configuration file to bind your D1 database to your Worker.
You can access your D1 databases via Hono's Context ↗︎ parameter: bindings ↗︎ are exposed on context.env. If you configured a binding named DB, then you would access D1 Workers Binding API methods via c.env.DB.
Refer to the Hono documentation for Cloudflare Workers ↗︎.

If you are using Pages Functions:

Bind a D1 database to your Pages Function.
Pass the --d1 BINDING_NAME=DATABASE_ID flag to wrangler dev when developing locally. BINDING_NAME should match what call in your code, and DATABASE_ID should match the database_id defined in your Wrangler configuration file: for example, --d1 DB=xxxx-xxxx-xxxx-xxxx-xxxx.
Refer to the Hono guide for Cloudflare Pages ↗︎.

The following examples show how to access a D1 database bound to DB from both a Workers script and a Pages Function:

import { Hono } from "hono";

// This ensures c.env.DB is correctly typed
type Bindings = {
    DB: D1Database;
};

const app = new Hono<{ Bindings: Bindings }>();

// Accessing D1 is via the c.env.YOUR_BINDING property
app.get("/query/users/:id", async (c) => {
    const userId = c.req.param("id");
    try {
        let { results } = await c.env.DB.prepare(
            "SELECT * FROM users WHERE user_id = ?",
        )
            .bind(userId)
            .run();
        return c.json(results);
    } catch (e) {
        return c.json({ err: "Failed to query user" }, 500);
    }
});

// Export our Hono app: Hono automatically exports a
// Workers 'fetch' handler for you
export default app;

import { Hono } from "hono";
import { handle } from "hono/cloudflare-pages";

// This ensures c.env.DB is correctly typed
type Bindings = {
    DB: D1Database;
};

const app = new Hono<{ Bindings: Bindings }>().basePath("/api");

// Accessing D1 is via the c.env.YOUR_BINDING property
app.get("/query/users/:id", async (c) => {
    const userId = c.req.param("id");
    try {
        let { results } = await c.env.DB.prepare(
            "SELECT * FROM users WHERE user_id = ?",
        )
            .bind(userId)
            .run();
        return c.json(results);
    } catch (e) {
        return c.json({ err: "Failed to query user" }, 500);
    }
});

// Export the Hono instance as a Pages onRequest function
export const onRequest = handle(app);

Was this helpful?

YesNo

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/d1/examples/d1-and-hono/#page","headline":"Query D1 from Hono","description":"Query D1 from the Hono web framework","url":"https://developers.cloudflare.com/d1/examples/d1-and-hono/","inLanguage":"en","image":"https://developers.cloudflare.com/d1/examples/d1-and-hono/og.png?v=cbb98b44a66dce77","dateModified":"2026-04-21","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"keywords":["Hono"]}

description: Query your D1 database from a Remix application. title: Query D1 from Remix image: https://developers.cloudflare.com/d1/examples/d1-and-remix/og.png?v=a5309d5e3d74dccb

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/d1/llms.txt
Use this file to discover all available pages before exploring further.

Query D1 from Hono

Query D1 from Hono

On this page