diff --git a/docs/app/(home)/page.tsx b/docs/app/(home)/page.tsx
index fb9796fce..6de6ebe84 100644
--- a/docs/app/(home)/page.tsx
+++ b/docs/app/(home)/page.tsx
@@ -14,7 +14,13 @@ const title = 'Make any TypeScript Function Durable';
 const description =
   '"use workflow" brings durability, reliability, and observability to async JavaScript. Build apps and AI Agents that can suspend, resume, and maintain state with ease.';
 
-export const metadata: Metadata = { title, description };
+export const metadata: Metadata = {
+  title: 'Workflow DevKit - Make any TypeScript Function Durable',
+  description,
+  alternates: {
+    canonical: '/',
+  },
+};
 
 const Home = () => (
   <>
diff --git a/docs/app/docs/[[...slug]]/page.tsx b/docs/app/docs/[[...slug]]/page.tsx
index 9f9f9ebde..e1426eefd 100644
--- a/docs/app/docs/[[...slug]]/page.tsx
+++ b/docs/app/docs/[[...slug]]/page.tsx
@@ -100,7 +100,10 @@ export async function generateMetadata(props: {
   if (!page) notFound();
 
   return {
-    title: page.data.title,
+    title: `${page.data.title} - Workflow DevKit`,
     description: page.data.description,
+    alternates: {
+      canonical: `/docs/${slug.join('/')}`,
+    },
   };
 }
diff --git a/docs/app/layout.tsx b/docs/app/layout.tsx
index 134e6e939..dfde3edad 100644
--- a/docs/app/layout.tsx
+++ b/docs/app/layout.tsx
@@ -5,6 +5,7 @@ import { Geist, Geist_Mono } from 'next/font/google';
 import { HomeLayout } from '@/components/layout/home';
 import { Toaster } from '@/components/ui/sonner';
 import { baseOptions } from '@/lib/layout.shared';
+import { Metadata } from 'next';
 
 const geistSans = Geist({
   variable: '--font-geist-sans',
@@ -16,6 +17,10 @@ const geistMono = Geist_Mono({
   subsets: ['latin'],
 });
 
+export const metadata: Metadata = {
+  metadataBase: new URL('https://useworkflow.dev'),
+};
+
 export default function Layout({ children }: { children: React.ReactNode }) {
   return (
     <html