Юрий Осипов · Основатель, SEO и аналитика

Sanity: структурный контент в облаке вендора

Идея Sanity в том, что контент — это данные, а не страницы. Звучит как рекламный слоган, пока не увидишь схему, где у записи типизированный слаг, ссылка на автора и локализованный массив блоков, и всё это можно запросить. Для сайта с настоящей структурой это разница между CMS и папкой с текстом.

Коротко

Что такое Sanity на практике

Две части одного продукта. Content Lake — облачное хранилище JSON‑документов со ссылками, черновиками и обработкой медиа, которое отдаётся через CDN. Studio — React‑приложение, которое вы настраиваете на TypeScript и размещаете где угодно.

// sanity.config.ts
import { defineConfig } from 'sanity'
import { structureTool } from 'sanity/structure'
import { post } from './schema/post'

export default defineConfig({
  projectId: process.env.SANITY_STUDIO_PROJECT_ID!,
  dataset: 'production',
  schema: { types: [post] },
  plugins: [structureTool()],
})

Полем может быть строка, массив Portable Text, ссылка на другой документ, изображение с точкой фокуса или вложенный объект. Документы локализуются по полям, а не целиком страницами — многоязычным сайтам нужно именно это.

Кому подходит

Не подходит, когда модель контента действительно простая, когда отдел закупок запрещает ещё одну подписку или когда бюджет — фиксированная сумма за проект без места для ежемесячного платежа.

Как связать с Astro

// src/lib/sanity.ts
import { sanityClient } from 'sanity:client'

const POSTS = /* groq */ `*[_type == "post"] | order(publishedAt desc) {
  title,
  "slug": slug.current,
  publishedAt,
  "author": author->name
}`

export const getPosts = () => sanityClient.fetch(POSTS)

sanity:client — виртуальный модуль, который @sanity/astro собирает из переменных окружения, так что обвязку писать не нужно. Интеграция даёт и помощник для URL изображений, учитывающий точку фокуса и кадрирование из студии. Это важно: кадрировать в CMS, а потом ещё раз в CSS — верный способ отрезать людям головы.

Для картинок через конвейер Astro добавьте CDN Sanity в список разрешённых внешних хостов; в остальных случаях хватает помощника.

Черновики — единственная нестатическая часть. Добавьте маршрут по запросу (или отдельный деплой для предпросмотра), который запрашивает данные с токеном, и подключите к нему Presentation. Публичные страницы остаются предрендеренными, предпросмотр работает по требованию.

Сильные стороны

Слабые стороны

Вопрос владения

Скажем прямо: в случае Sanity вы арендуете слой контента. Студия ваша, схема ваша, запросы ваши — хранилище нет. Для большинства клиентов это честный обмен, примерно как с корпоративной почтой. Проблемой это становится в день, когда правило закупки, требование к хранению данных или резкое изменение цены превращают вендора из удобства в риск. Этот вопрос лучше задать до миграции, а не после.

Когда выбирать Sanity

Выбирайте, когда контент‑процесс и есть продукт: много редакторов, несколько языков и потребность в структурированных данных, которые читают другие системы. И когда в команде нет человека, готового отвечать за базу данных в два часа ночи.

Если наоборот — CMS в вашем репозитории и на вашей инфраструктуре, читайте руководство по Payload. Если важнее визуальное редактирование страницы с библиотекой компонентов, ближе Storyblok.

Итог

Sanity меняет инфраструктуру на зависимость, и для контентных команд этот обмен обычно выгоден. Вы получаете самый сильный опыт структурного редактирования из пяти вариантов, официальную интеграцию с Astro и честный путь выгрузки данных.

Сравнение с альтернативами — в материале какая headless CMS лучше для Astro, общая картина — на хабе headless CMS. Мы делаем сайты на Astro с Sanity и переводим на них проекты — это часть разработки сайтов.

Скриншоты в этой серии — план; мы заменим их собственными, снятыми на реальных проектах.

Юрий Осипов

Юрий Осипов

Основатель, SEO и аналитика

Руководит Take the Space. Специализируется на техническом SEO, измеримой аналитике и видимости в ИИ‑поиске.

Все статьи автора →
Sanity хорошо подходит для Astro?
Да. У Sanity есть официальная интеграция для Astro: она даёт настроенный клиент и помощник для изображений, а контент достаточно структурирован, чтобы его нормально типизировать. Сборка забирает данные из Content Lake, а черновики и визуальное редактирование идут отдельным путём предпросмотра.
Можно ли развернуть Sanity у себя?
Студию — да, её можно собрать и разместить где угодно, в том числе внутри своего приложения. Но сам контент хранится в облачном Content Lake, self‑hosted версии бэкенда не существует: вендор остаётся частью вашей архитектуры.
Что такое GROQ и обязательно ли его учить?
Это язык запросов Sanity, заточенный под структурированный JSON. Вместо него можно взять GraphQL, но документация и инструменты предпросмотра в основном предполагают GROQ. После двух‑трёх запросов он читается как обычный фильтр по JSON.
Как редактор видит свои правки на настоящей странице?
Инструмент Presentation открывает сайт в панели и накладывает на него кликабельные поля: нажали на заголовок — попали в нужный input. Для этого нужна среда предпросмотра, которая рендерит черновики, — в Astro это небольшой серверный маршрут.
Что будет с контентом, если мы уйдём из Sanity?
Датасет можно выгрузить в NDJSON в любой момент, вместе с черновиками, изображениями и ссылками между документами. Собрать ту же структуру в другом месте — работа, но данные у вас не в заложниках.

Нужен высокопроизводительный сайт?

Давайте обсудим, как мы можем помочь вашему бизнесу расти.