diff --git a/apps/docs/client/src/content/deco-studio/en/studio/agentic-cms.mdx b/apps/docs/client/src/content/deco-studio/en/studio/agentic-cms.mdx
index 1987812338..119ecea407 100644
--- a/apps/docs/client/src/content/deco-studio/en/studio/agentic-cms.mdx
+++ b/apps/docs/client/src/content/deco-studio/en/studio/agentic-cms.mdx
@@ -52,6 +52,24 @@ If you're coming from deco.cx, the Agentic CMS is the same product line — same
 
 Existing deco.cx projects continue to work. Migration adds the agent layer; it doesn't replace your codebase.
 
+## Sections editor
+
+The **Content** tab in the agent workspace is the visual editor for the sections and pages that make up your storefront. It shows two groups — **Saved sections** (reusable global blocks) and **Available sections** (every component in the manifest catalog) — searchable from a single input.
+
+### Variants
+
+Each section or page can have multiple **variants** — alternate configurations with different props or matcher-controlled conditions (A/B tests, audience segments, date windows). Variants appear as a list under their parent section in the editor.
+
+You can:
+
+- **Reorder variants** by dragging them up or down in the list. The order controls evaluation priority when multiple matchers could apply.
+- **Preview a specific variant** by clicking it — the preview pane immediately applies that variant so you see exactly what a visitor matching that condition would see.
+- **Save as a global section** to persist a configured variant as a reusable block available across your entire storefront.
+
+<Callout type="tip">
+  Scroll position in the preview is preserved when you switch between variants or save changes, so you can stay focused on the section you're editing without losing your place on the page.
+</Callout>
+
 ## Getting started
 
 Open Studio, find the **deco Site Editor** agent and point it at your site.
diff --git a/apps/docs/client/src/content/deco-studio/pt-br/studio/agentic-cms.mdx b/apps/docs/client/src/content/deco-studio/pt-br/studio/agentic-cms.mdx
index b19a21c0e9..fdd9641d95 100644
--- a/apps/docs/client/src/content/deco-studio/pt-br/studio/agentic-cms.mdx
+++ b/apps/docs/client/src/content/deco-studio/pt-br/studio/agentic-cms.mdx
@@ -52,6 +52,24 @@ Se você está vindo do deco.cx, o Agentic CMS é a mesma linha de produto — o
 
 Projetos deco.cx existentes continuam funcionando. A migração adiciona a camada de agents; ela não substitui sua base de código.
 
+## Editor de sections
+
+A aba **Content** no workspace do agent é o editor visual para as sections e páginas que compõem o seu storefront. Ela exibe dois grupos — **Saved sections** (blocos globais reutilizáveis) e **Available sections** (todos os componentes do catálogo do manifesto) — com busca em uma única caixa de texto.
+
+### Variantes
+
+Cada section ou página pode ter múltiplas **variantes** — configurações alternativas com props diferentes ou condições controladas por matchers (testes A/B, segmentos de audiência, janelas de datas). As variantes aparecem como uma lista abaixo da section pai no editor.
+
+Você pode:
+
+- **Reordenar variantes** arrastando-as para cima ou para baixo na lista. A ordem controla a prioridade de avaliação quando múltiplos matchers podem se aplicar.
+- **Visualizar uma variante específica** clicando nela — o painel de preview aplica imediatamente aquela variante, para que você veja exatamente o que um visitante que corresponde àquela condição veria.
+- **Salvar como section global** para persistir uma variante configurada como um bloco reutilizável disponível em todo o seu storefront.
+
+<Callout type="tip">
+  A posição de scroll no preview é preservada ao trocar de variante ou salvar alterações, para que você possa manter o foco na section que está editando sem perder o lugar na página.
+</Callout>
+
 ## Primeiros passos
 
 Abra o Studio, encontre o agent **deco Site Editor** e aponte-o para o seu site.