anttiviljami · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026 · Oct 20, 2026
diff --git a/docs/apps/components/external-product-catalog.md b/docs/apps/components/external-product-catalog.md
@@ -2,6 +2,7 @@
 title: External Product Catalog
 hide_title: true
 sidebar_position: 7
+description: "Integrate an external product catalog with epilot by adding an External Product Catalog component to your App and configuring its hooks in the component editor."
 ---
 
 <h1 align="center">External Product Catalog</h1>

diff --git a/docs/apps/components/overview.md b/docs/apps/components/overview.md
@@ -2,6 +2,7 @@
 title: Overview
 hide_title: true
 sidebar_position: 1
+description: "Components are the building blocks of every epilot App. Each component type extends a specific part of the platform, such as entity pages, journeys, portals or flows."
 ---
 
 <p>&nbsp;</p>

diff --git a/docs/apps/components/portal-extension.md b/docs/apps/components/portal-extension.md
@@ -2,6 +2,7 @@
 title: Portal Extensions
 hide_title: true
 sidebar_position: 6
+description: "Extend epilot portals with custom functionality and third-party integrations, from seamless links to hooks for data retrieval, validation and export."
 ---
 
 <h1 align="center">Portal Extensions</h1>

diff --git a/docs/apps/functions/deploy-and-update.md b/docs/apps/functions/deploy-and-update.md
@@ -2,6 +2,7 @@
 title: Deploying & Updating
 hide_title: true
 sidebar_position: 5
+description: "Add, deploy and update App functions with the epilot CLI: scaffold workflow or scheduled functions, deploy them and learn how updates reach installations."
 ---
 
 # Deploying & Updating Functions

diff --git a/docs/apps/how-to-guides/build-a-custom-jb.md b/docs/apps/how-to-guides/build-a-custom-jb.md
@@ -2,6 +2,7 @@
 title: "How to build a custom Journey block"
 hide_title: true
 sidebar_position: 1
+description: "Step-by-step guide to building a custom Journey block as an epilot App: a block that shows the address entered in the journey as a marker on an OpenStreetMap map."
 ---
 
 ## How to build a custom Journey block

diff --git a/docs/apps/overview.md b/docs/apps/overview.md
@@ -10,7 +10,7 @@ import DocCards from '@site/src/components/DocCards';
 
 # Build Apps for epilot
 
-epilot is the Energy XRM that Apps extend. Add custom UI to entity pages, journeys, and portals, run your own code inside flows, and connect external systems — then install your App privately or publish it to the epilot Marketplace.
+epilot is the energy XRM that Apps extend. Add custom UI to entity pages, journeys, and portals, run your own code inside flows, and connect external systems — then install your App privately or publish it to the epilot Marketplace.
 
 ## Get started
 

diff --git a/docs/audit-logs.md b/docs/audit-logs.md
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 14
+description: "Audit logs are a tamper-resistant record of who did what, when and on which resource in your epilot organization, for security reviews, compliance and troubleshooting."
 ---
 
 # Audit Logs

diff --git a/docs/auth/access-tokens.md b/docs/auth/access-tokens.md
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 2
+description: "Authorize epilot API calls with Access Tokens: create, restrict (read-only or anonymized), use and revoke tokens for integrations and scripts."
 ---
 
 # Access Tokens

diff --git a/docs/auth/anonymization.md b/docs/auth/anonymization.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 2.5
 title: PII Anonymization
+description: "epilot can mask personal data (PII) in API responses so AI assistants, analytics and integrations get the shape and relations of your data without personal identifiers."
 ---
 
 # PII Anonymization

diff --git a/docs/auth/permissions.md b/docs/auth/permissions.md
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 4
+description: "epilot permissions use role-based access control (RBAC) with attribute-based conditions, inspired by AWS IAM policies, for fine-grained control by role, resource and attribute."
 ---
 
 # Permissions

diff --git a/docs/automation/architecture.md b/docs/automation/architecture.md
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 10
+description: "How the epilot automation engine works: a serverless, event-driven pipeline on AWS Lambda, DynamoDB, EventBridge and SQS that matches entity events to flows and runs their actions."
 ---
 
 # Architecture

diff --git a/docs/automation/automation-executions.md b/docs/automation/automation-executions.md
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 3
+description: "Every time an Automation Flow is triggered, epilot creates an Automation Execution. Learn how executions run their actions and which execution statuses exist."
 ---
 
 # Automation Executions

diff --git a/docs/automation/automation-flows.md b/docs/automation/automation-flows.md
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 2
+description: "Automation Flows are epilot's automation configurations: the triggers that start them and the actions they run on entities."
 ---
 
 # Automation Flows

diff --git a/docs/automation/entity-mapping.md b/docs/automation/entity-mapping.md
@@ -1,5 +1,6 @@
 ---
 sidebar_position: 4
+description: "Use the Create/Edit Entity (Advanced) automation action to map data from one entity into new or existing entities, with attribute mappings and mapping operations."
 ---
 
 # Entity Mapping

diff --git a/docs/automation/event-catalog-trigger.md b/docs/automation/event-catalog-trigger.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 5
 title: Event Catalog Trigger
+description: "The Event Catalog trigger starts an Automation Flow whenever a Core Event, such as CustomerRequestSubmitted or MeterReadingAdded, is published in your organization."
 ---
 
 # Event Catalog Trigger

diff --git a/docs/automation/intro.md b/docs/automation/intro.md
@@ -1,6 +1,7 @@
 ---
 title: Overview
 sidebar_position: 1
+description: "epilot automation is a general-purpose framework for executing actions on entities in response to events."
 ---
 
 # Automation

diff --git a/docs/blueprints/editing-and-synchronizing.md b/docs/blueprints/editing-and-synchronizing.md
@@ -2,6 +2,7 @@
 sidebar_position: 3
 title: Editing and synchronizing
 hide_title: true
+description: "Edit a Blueprint in the Blueprint overview (rename it, add or remove resources, download or delete it) and synchronize it with another organization."
 ---
 
 ## Editing Blueprints 

diff --git a/docs/blueprints/installing-a-blueprint.md b/docs/blueprints/installing-a-blueprint.md
@@ -2,6 +2,7 @@
 sidebar_position: 2
 title: Installing a Blueprint
 hide_title: true
+description: "Install a Blueprint from the epilot Marketplace with a one-click or advanced install, configure it after installation, or create your own custom Blueprint."
 ---
 
 

diff --git a/docs/blueprints/intro.md b/docs/blueprints/intro.md
@@ -1,6 +1,7 @@
 ---
 title: Blueprints
 sidebar_position: 1
+description: "Blueprints from the epilot Marketplace bundle journeys, automations, entity schemas, templates and more, so companies can launch energy use cases in a few clicks."
 ---
 
 # Blueprints

diff --git a/docs/blueprints/sandboxes.md b/docs/blueprints/sandboxes.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 5
 title: Sandboxes
+description: "A Sandbox is a separate epilot organization for safely testing configurations without affecting production. Validated changes can be promoted to production."
 ---
 
 # Sandboxes

diff --git a/docs/blueprints/supported-resources.md b/docs/blueprints/supported-resources.md
@@ -1,6 +1,7 @@
 ---
 sidebar_position: 10
 title: Supported Resources
+description: "Resource types that Blueprints support, each corresponding to a ResourceNodeType in the Blueprint Manifest API."
 ---
 
 # Supported Resources

diff --git a/docs/cli/commands/access-token.md b/docs/cli/commands/access-token.md
@@ -1,5 +1,6 @@
 ---
 title: "Access Token API"
+description: "epilot CLI commands for the Access Token API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Access Token API

diff --git a/docs/cli/commands/address-suggestions.md b/docs/cli/commands/address-suggestions.md
@@ -1,5 +1,6 @@
 ---
 title: "Address Suggestions API"
+description: "epilot CLI commands for the Address Suggestions API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Address Suggestions API

diff --git a/docs/cli/commands/address.md b/docs/cli/commands/address.md
@@ -1,5 +1,6 @@
 ---
 title: "Address API"
+description: "epilot CLI commands for the Address API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Address API

diff --git a/docs/cli/commands/ai-agents.md b/docs/cli/commands/ai-agents.md
@@ -1,5 +1,6 @@
 ---
 title: "AI Agents API - OpenAPI 3.0"
+description: "epilot CLI commands for the AI Agents API - OpenAPI 3.0: quick start, common flags and every operation, callable from the command line."
 ---
 
 # AI Agents API - OpenAPI 3.0

diff --git a/docs/cli/commands/app.md b/docs/cli/commands/app.md
@@ -1,5 +1,6 @@
 ---
 title: "App API"
+description: "epilot CLI commands for the App API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # App API

diff --git a/docs/cli/commands/audit-logs.md b/docs/cli/commands/audit-logs.md
@@ -1,5 +1,6 @@
 ---
 title: "Audit Log"
+description: "epilot CLI commands for the Audit Log: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Audit Log

diff --git a/docs/cli/commands/automation.md b/docs/cli/commands/automation.md
@@ -1,5 +1,6 @@
 ---
 title: "Automation API"
+description: "epilot CLI commands for the Automation API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Automation API

diff --git a/docs/cli/commands/billing.md b/docs/cli/commands/billing.md
@@ -1,5 +1,6 @@
 ---
 title: "Billing API"
+description: "epilot CLI commands for the Billing API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Billing API

diff --git a/docs/cli/commands/blueprint-manifest.md b/docs/cli/commands/blueprint-manifest.md
@@ -1,5 +1,6 @@
 ---
 title: "Blueprint Manifest API"
+description: "epilot CLI commands for the Blueprint Manifest API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Blueprint Manifest API

diff --git a/docs/cli/commands/consent.md b/docs/cli/commands/consent.md
@@ -1,5 +1,6 @@
 ---
 title: "Consent API"
+description: "epilot CLI commands for the Consent API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Consent API

diff --git a/docs/cli/commands/customer-portal.md b/docs/cli/commands/customer-portal.md
@@ -1,5 +1,6 @@
 ---
 title: "Portal API"
+description: "epilot CLI commands for the Portal API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Portal API

diff --git a/docs/cli/commands/dashboard.md b/docs/cli/commands/dashboard.md
@@ -1,5 +1,6 @@
 ---
 title: "Dashboard API"
+description: "epilot CLI commands for the Dashboard API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Dashboard API

diff --git a/docs/cli/commands/data-governance.md b/docs/cli/commands/data-governance.md
@@ -1,5 +1,6 @@
 ---
 title: "Data Governance API"
+description: "epilot CLI commands for the Data Governance API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Data Governance API

diff --git a/docs/cli/commands/deduplication.md b/docs/cli/commands/deduplication.md
@@ -1,5 +1,6 @@
 ---
 title: "Deduplication API"
+description: "epilot CLI commands for the Deduplication API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Deduplication API

diff --git a/docs/cli/commands/design.md b/docs/cli/commands/design.md
@@ -1,5 +1,6 @@
 ---
 title: "Design Builder API v2"
+description: "epilot CLI commands for the Design Builder API v2: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Design Builder API v2

diff --git a/docs/cli/commands/document.md b/docs/cli/commands/document.md
@@ -1,5 +1,6 @@
 ---
 title: "Document API"
+description: "epilot CLI commands for the Document API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Document API

diff --git a/docs/cli/commands/email-settings.md b/docs/cli/commands/email-settings.md
@@ -1,5 +1,6 @@
 ---
 title: "Messaging Settings API"
+description: "epilot CLI commands for the Messaging Settings API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Messaging Settings API

diff --git a/docs/cli/commands/email-template.md b/docs/cli/commands/email-template.md
@@ -1,5 +1,6 @@
 ---
 title: "Email template API"
+description: "epilot CLI commands for the Email template API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Email template API

diff --git a/docs/cli/commands/entity-mapping.md b/docs/cli/commands/entity-mapping.md
@@ -1,5 +1,6 @@
 ---
 title: "Entity Mapping API"
+description: "epilot CLI commands for the Entity Mapping API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Entity Mapping API

diff --git a/docs/cli/commands/entity.md b/docs/cli/commands/entity.md
@@ -1,5 +1,6 @@
 ---
 title: "Entity API"
+description: "epilot CLI commands for the Entity API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Entity API

diff --git a/docs/cli/commands/environments.md b/docs/cli/commands/environments.md
@@ -1,5 +1,6 @@
 ---
 title: "Environments API"
+description: "epilot CLI commands for the Environments API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Environments API

diff --git a/docs/cli/commands/erp-integration.md b/docs/cli/commands/erp-integration.md
@@ -1,5 +1,6 @@
 ---
 title: "ERP Integration API"
+description: "epilot CLI commands for the ERP Integration API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # ERP Integration API

diff --git a/docs/cli/commands/event-catalog.md b/docs/cli/commands/event-catalog.md
@@ -1,5 +1,6 @@
 ---
 title: "Event Catalog API"
+description: "epilot CLI commands for the Event Catalog API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Event Catalog API

diff --git a/docs/cli/commands/file.md b/docs/cli/commands/file.md
@@ -1,5 +1,6 @@
 ---
 title: "File API"
+description: "epilot CLI commands for the File API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # File API

diff --git a/docs/cli/commands/iban.md b/docs/cli/commands/iban.md
@@ -1,5 +1,6 @@
 ---
 title: "Iban API"
+description: "epilot CLI commands for the Iban API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Iban API

diff --git a/docs/cli/commands/journey.md b/docs/cli/commands/journey.md
@@ -1,5 +1,6 @@
 ---
 title: "Journey API"
+description: "epilot CLI commands for the Journey API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Journey API

diff --git a/docs/cli/commands/kanban.md b/docs/cli/commands/kanban.md
@@ -1,5 +1,6 @@
 ---
 title: "Kanban API"
+description: "epilot CLI commands for the Kanban API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Kanban API

diff --git a/docs/cli/commands/message.md b/docs/cli/commands/message.md
@@ -1,5 +1,6 @@
 ---
 title: "Message API"
+description: "epilot CLI commands for the Message API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Message API

diff --git a/docs/cli/commands/metering.md b/docs/cli/commands/metering.md
@@ -1,5 +1,6 @@
 ---
 title: "Metering API"
+description: "epilot CLI commands for the Metering API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Metering API

diff --git a/docs/cli/commands/notes.md b/docs/cli/commands/notes.md
@@ -1,5 +1,6 @@
 ---
 title: "Notes API"
+description: "epilot CLI commands for the Notes API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Notes API

diff --git a/docs/cli/commands/notification.md b/docs/cli/commands/notification.md
@@ -1,5 +1,6 @@
 ---
 title: "Notification API"
+description: "epilot CLI commands for the Notification API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Notification API

diff --git a/docs/cli/commands/organization.md b/docs/cli/commands/organization.md
@@ -1,5 +1,6 @@
 ---
 title: "Organization API"
+description: "epilot CLI commands for the Organization API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Organization API

diff --git a/docs/cli/commands/partner-directory.md b/docs/cli/commands/partner-directory.md
@@ -1,5 +1,6 @@
 ---
 title: "Partner API"
+description: "epilot CLI commands for the Partner API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Partner API

diff --git a/docs/cli/commands/permissions.md b/docs/cli/commands/permissions.md
@@ -1,5 +1,6 @@
 ---
 title: "Permissions API"
+description: "epilot CLI commands for the Permissions API: quick start, common flags and every operation, callable from the command line."
 ---
 
 # Permissions API