Skip to content
Grav 2.0 is officially stable. Read the announcement →
Grav 2.0 is here

A CMS for humans & agents

Grav 2.0 keeps everything you love about Grav: fast, flat-file, Markdown, YAML, Multi-lang, now with a first-party API, an MCP server, and a new SPA admin built on SvelteKit 5.

Download Grav 2.0 Migrate from 1.x
Stable 2.0.0 NEW 1 day ago
What's new
Grav 2.0

The 2.0 leap

A first-party API, a modern SPA admin, and an MCP server, all on one consistent interface.

ADMIN 2.0

A modern admin, rebuilt from scratch.

SvelteKit 5, Vite, Tailwind 4. Instant SPA navigation, a customizable dashboard, real-time collaborative editing, CodeMirror, Uppy media. And every blueprint you already use just works.

Meet Admin 2.0
FIRST-PARTY API

The foundation 2.0 is built on.

A stable REST API powers the admin, respects Grav’s permission model, and is plugin-extensible. Headless frontends, CI/CD, mobile apps: all first-class citizens.

Explore the API
MCP SERVER

Built for agents, too.

Admin 2.0 is for humans. The MCP server is for AI. Both go through the same API, with the same permissions. No AI sidecar, no duct tape.

See the MCP server
Read the 2.0 announcement How to migrate to 2.0
Admin 2.0

Your new command center

The classic admin has been completely replaced. Admin 2.0 is a modern single-page application built on SvelteKit 5, Vite, and Tailwind 4, talking to Grav through the new first-party API.

A customizable dashboard you can reorder and resize per user. Real-time collaborative editing with named cursors and live presence, powered by the sync plugin (or sync-mercure for sub-100ms SSE updates). A built-in CodeMirror editor, Uppy-powered media, and a polished TypeScript component library. Every blueprint, form field, and workflow you already use just works.

No database API-first Agent-ready Customizable dashboard Real-time collab Markdown + YAML Git-friendly
GRAV
Dashboard
Configuration
Users 1
Pages 68
Media 6
Plugins 34
Themes 4
Tools
Licenses
Image Optimize
YetiSearch Pro
Admin
Grav v2.0.0-beta.1
localhost
View site
Dashboard
Welcome back, Admin
Refresh
68
Pages
1
Users
34
Plugins (31 active)
quark2
Active Theme
Page Views
426 wk 706 mo
Updates
Everything up to date
System
Gravv2.0.0
PHPv8.3.30
A modern stack

Built for developers who need to ship fast

create-page.ts
1  import { GravClient } from '@grav/sdk';
2
3  const grav = new GravClient({
4    baseUrl: 'https://site.com/api/v1',
5    token:   process.env.GRAV_TOKEN!,
6  });
7
8  // Create a new blog post
9  await grav.pages.create({
10   route:    '/blog/grav-2-is-here',
11   template: 'item',
12   header:   { title: 'Grav 2.0 is here' },
13   content:  '# Ship it. 🚀',
14 });
15
16 // Same endpoint the admin — and MCP — uses

Grav 2.0 runs on a completely modern stack: PHP 8.3+, Symfony 7, Twig 3, all on their latest stable releases. Clean PHP throughout, and a forward-compatible foundation for PHP 8.4 and 8.5.

Every operation in the admin is a call against the first-party API: the same API your code, your CI pipeline, and your agents talk to. Headless when you want it, monolithic when you don’t.

PHP 8.3+ Twig 3 Symfony 7 Composer 2 Markdown YAML
Batteries included

Everything you need, built in

API

First-Party API

REST endpoints with proper auth, respecting Grav’s permission model. Plugin-extensible out of the box.

AGENTIC

Built-in MCP Server

Same API, same permissions. Agentic AI gets the same access as a human admin, with no sidecar.

ADMIN

Admin 2.0 SPA

SvelteKit 5 + Vite + Tailwind 4. Instant navigation, modern UX, every existing blueprint just works.

SPEED

Sub-100ms Pages

Aggressive caching plus PHP 8.3+ runtime gains delivers page renders in under a blink.

FLAT-FILE

No Database

Your content is a folder of files. Git-version it, rsync it, move it anywhere. Zero lock-in.

SECURE

Modern Security

Zero SQL surface. Latest Symfony & Twig with all upstream hardening. API authn designed for 2026.

DISCOVERY

Full-Text Search

SimpleSearch out of the box, YetiSearch Pro for production. No Elasticsearch required.

GLOBAL

Multi-Language Ready

Built-in internationalization. Ship the same content in every language you need.

MEDIA

Automatic Image Pipeline

Resize, crop, and optimize with a fluent API. Responsive images on autopilot.

Built for docs

A first-class platform for documentation

Flat-file + Markdown + Git is the perfect foundation for technical docs. Pair it with Helios and you have a world-class documentation stack.

Your docs live as plain Markdown, version-controlled alongside your code. No database round-trips mean pages render in under 100ms. And with the 2.0 API, your docs become automatable: regenerate from source, ship on CI, publish from agents.

Helios is the premium documentation theme from the Grav team. Three-column layout with scroll-spy TOC, built on Tailwind 4 and Alpine.js, with folder-based versioning and 200+ languages of syntax highlighting out of the box.

Three-column layout
Sidebar nav + content + on-page TOC.
Folder-based versioning
Smart detection & switching.
Cmd+K search
SimpleSearch or YetiSearch Pro.
200+ language highlighting
70+ themes. Line numbers, diffs, focus mode.
Dark & light modes
With 5 color presets + custom.
Docs components
Callouts, cards, steps, tabs, file trees.
THE THEME
Helios
$50

Helios theme & lifetime updates.

Recommended
TEAM BUNDLE
Helios Publisher
$140

Helios + Editor Pro + Revisions Pro. Save $35.

ENTERPRISE BUNDLE
Helios Publisher Pro
$200

Everything in Publisher, plus YetiSearch Pro. Save $50.

Explore Helios See publisher bundles
Why Grav

Why teams stick with Grav

01

API-first

Everything the admin can do, your code can do too. Headless, CI-driven, plugin-extensible: one API for all of it.

02

Agent-ready

The first-party MCP server gives agentic AI the same access as a human admin. Zero extra wiring, same permission model.

03

Modern stack

PHP 8.3+, Symfony 7, Twig 3; all on their latest stable releases. Forward-compatible foundation for the next decade of PHP.

04

Zero lock-in

Your content is plain Markdown. Move it anywhere. Turn it into a static site. Generate an ebook. Export is never a migration.

Community

Built with the community

Thousands of developers around the world building, extending, and contributing, now shipping Grav 2.0 together.

15,535
GitHub stars
5,772
Twitter followers
225
Discord members
12
Years of Grav
Star on GitHub
getgrav/grav
Join the Discord
225 members online
Visit the Forum
10k+ threads
Versatile by design

One CMS, any kind of site

Personal blogs, company sites, large documentation hubs, and everything in between. If you can structure it in folders, you can build it with Grav.

Blogs Business Sites Directories Documentation Landing Pages Portfolios Product Sites Docs Sites
Built with Grav

In good company

Organizations that have shipped sites, docs, and campaigns on Grav.

Ready to ship?

Ship with Grav 2.0 today

Download, unzip, and you’re live: a flat-file CMS with a modern admin and a first-party API out of the box. Add the MCP server with one click when you’re ready for agents.