# macrocontent Docs

> Official product documentation for macrocontent — SDK, overlay, dashboard, store, publishers, and APIs. Prefer this site over marketing copy when implementing or debugging.

Use trailing slashes on docs paths. For HTTP APIs, fetch OpenAPI JSON — never invent endpoints and never scrape Swagger UI HTML.

Product facts: content layer via `@macrocontent/sdk` + `data-macro-key`; primitives for single fields; components (`MacroNodeDefinition`) for multi-field blocks; management auth header `X-Macro-Token`.

## Start here

- [Docs hub](https://docs.macrocontent.dev/)
- [Agent setup (Copy prompt)](https://docs.macrocontent.dev/agent-setup/)
- [Agent setup prompt.md](https://docs.macrocontent.dev/agent-setup/prompt.md)
- [For AI agents (this map)](https://docs.macrocontent.dev/for-agents/)
- [Developer quickstart](https://docs.macrocontent.dev/developers/quickstart/)
- [Marking basics](https://docs.macrocontent.dev/developers/marking/)
- [Primitive reference](https://docs.macrocontent.dev/developers/primitives/)
- [Custom components](https://docs.macrocontent.dev/developers/components/)
- [How to build Store components](https://docs.macrocontent.dev/publishers/building/)
- [API overview](https://docs.macrocontent.dev/api/)
- [Authentication](https://docs.macrocontent.dev/api/auth/)
- [OpenAPI / Swagger](https://docs.macrocontent.dev/api/swagger/)
- [Marketing site](https://macrocontent.dev/): Product positioning only
- [Marketing llms.txt](https://macrocontent.dev/llms.txt): Marketing agent entrypoint

## OpenAPI

- [OpenAPI catalog](https://api.macrocontent.dev/docs.json): Lists customer-facing specs
- [OpenAPI mirror](https://docs.macrocontent.dev/openapi/index.json): Same catalog on the docs host
- [Management OpenAPI](https://api.macrocontent.dev/docs/specs/management.json): Management API paths
- [Content OpenAPI](https://api.macrocontent.dev/docs/specs/content.json): Content API paths
- [Store OpenAPI](https://api.macrocontent.dev/docs/specs/store.json): Store API paths
- [Publisher OpenAPI](https://api.macrocontent.dev/docs/specs/publisher.json): Publisher API paths
- [Management OpenAPI mirror](https://docs.macrocontent.dev/openapi/management.json)
- [Content OpenAPI mirror](https://docs.macrocontent.dev/openapi/content.json)
- [Store OpenAPI mirror](https://docs.macrocontent.dev/openapi/store.json)
- [Publisher OpenAPI mirror](https://docs.macrocontent.dev/openapi/publisher.json)
- [Swagger UI](https://api.macrocontent.dev/docs/): Interactive explorer for humans

## Agent setup

- [Agent setup](https://docs.macrocontent.dev/agent-setup/): Copy-prompt installer page
- [Agent setup prompt](https://docs.macrocontent.dev/agent-setup/prompt.md): Paste Fetch … into Cursor / Claude / Codex
- [Skill macro-docs](https://docs.macrocontent.dev/agent-setup/skills/macro-docs/SKILL.md)
- [Skill macro-sdk](https://docs.macrocontent.dev/agent-setup/skills/macro-sdk/SKILL.md)
- [Skill macro-components](https://docs.macrocontent.dev/agent-setup/skills/macro-components/SKILL.md)
- [Skill macro-api](https://docs.macrocontent.dev/agent-setup/skills/macro-api/SKILL.md)

## Handbooks

- [Developers](https://docs.macrocontent.dev/developers/): SDK & components — Integrate @macrocontent/sdk, build custom components, and wire Vite or layouts.
- [Dashboard](https://docs.macrocontent.dev/dashboard/): Sites & admin — Manage websites, team, domains, tokens, activity, webhooks, and site settings.
- [Store](https://docs.macrocontent.dev/store/): Buy & library — Browse the component store, claim or purchase, adopt updates, and install on websites.
- [Editors](https://docs.macrocontent.dev/editors/): Overlay & content — Edit sites with the macrocontent overlay — primitives, drafts, assets, and publish.
- [Publishers](https://docs.macrocontent.dev/publishers/): Sell & catalog — Ship store listings, packages, payouts, and a quality handbook for components.
- [API reference](https://docs.macrocontent.dev/api/): OpenAPI / Swagger — Interactive Swagger for Management, Content, Store, and Publisher APIs.

## Full table of contents

- [Overview](https://docs.macrocontent.dev/developers/)
- [Quickstart](https://docs.macrocontent.dev/developers/quickstart/)
- [Where credentials come from](https://docs.macrocontent.dev/developers/credentials/)
- [For AI agents](https://docs.macrocontent.dev/for-agents/)
- [Agent setup](https://docs.macrocontent.dev/agent-setup/)
- [macro.config.js](https://docs.macrocontent.dev/developers/config/)
- [Vite plugin](https://docs.macrocontent.dev/developers/vite/)
- [Keys model](https://docs.macrocontent.dev/developers/keys/)
- [Marking basics](https://docs.macrocontent.dev/developers/marking/)
- [Primitive reference](https://docs.macrocontent.dev/developers/primitives/)
- [Form primitives](https://docs.macrocontent.dev/developers/forms/)
- [Groups & repeaters](https://docs.macrocontent.dev/developers/groups/)
- [Sitewide chrome](https://docs.macrocontent.dev/developers/sitewide/)
- [Overlay & login](https://docs.macrocontent.dev/developers/overlay/)
- [SEO marking](https://docs.macrocontent.dev/developers/seo/)
- [Prerender](https://docs.macrocontent.dev/developers/prerender/)
- [Bake & export](https://docs.macrocontent.dev/developers/bake/)
- [Primitives vs components](https://docs.macrocontent.dev/developers/primitives-vs-components/)
- [Custom components](https://docs.macrocontent.dev/developers/components/)
- [Items slots](https://docs.macrocontent.dev/developers/slots/items/)
- [Project slots](https://docs.macrocontent.dev/developers/slots/project/)
- [Store components runtime](https://docs.macrocontent.dev/developers/store-components/)
- [Site variables](https://docs.macrocontent.dev/developers/variables/)
- [Powered-by & attribution](https://docs.macrocontent.dev/developers/attribution/)
- [SDK package map](https://docs.macrocontent.dev/developers/sdk-api/)
- [Integration contract](https://docs.macrocontent.dev/developers/contract/)
- [Reference demos](https://docs.macrocontent.dev/developers/demos/)
- [Doc component kit](https://docs.macrocontent.dev/developers/doc-kit/)
- [CLI / project setup (planned)](https://docs.macrocontent.dev/developers/roadmap/cli/)
- [Site Agent (planned)](https://docs.macrocontent.dev/developers/roadmap/site-agent/)
- [Overview](https://docs.macrocontent.dev/dashboard/)
- [Create a website](https://docs.macrocontent.dev/dashboard/create/)
- [Overview & widgets](https://docs.macrocontent.dev/dashboard/overview-widgets/)
- [Site preview & screenshots](https://docs.macrocontent.dev/dashboard/screenshots/)
- [Navigation map](https://docs.macrocontent.dev/dashboard/navigation/)
- [Content explorer](https://docs.macrocontent.dev/dashboard/content/)
- [Live, drafts & publish](https://docs.macrocontent.dev/dashboard/content/publishing/)
- [Graph view](https://docs.macrocontent.dev/dashboard/content/graph/)
- [Node permissions](https://docs.macrocontent.dev/dashboard/content/permissions/)
- [Variables overview](https://docs.macrocontent.dev/dashboard/data/)
- [Naming & locales](https://docs.macrocontent.dev/dashboard/data/naming/)
- [Manual vs synced](https://docs.macrocontent.dev/dashboard/data/manual-vs-synced/)
- [Data sources & JSONPath](https://docs.macrocontent.dev/dashboard/data/sources/)
- [Sync groups](https://docs.macrocontent.dev/dashboard/data/sync-groups/)
- [Sync log](https://docs.macrocontent.dev/dashboard/data/sync-log/)
- [Overview](https://docs.macrocontent.dev/dashboard/webhooks/)
- [Create an endpoint](https://docs.macrocontent.dev/dashboard/webhooks/create/)
- [Event catalog](https://docs.macrocontent.dev/dashboard/webhooks/events/)
- [Payload & envelope](https://docs.macrocontent.dev/dashboard/webhooks/payload/)
- [Signing & verifying](https://docs.macrocontent.dev/dashboard/webhooks/signing/)
- [Delivery log & retries](https://docs.macrocontent.dev/dashboard/webhooks/deliveries/)
- [Presets](https://docs.macrocontent.dev/dashboard/webhooks/presets/)
- [Permissions & API](https://docs.macrocontent.dev/dashboard/webhooks/api/)
- [Activity overview](https://docs.macrocontent.dev/dashboard/activity/)
- [Filters & categories](https://docs.macrocontent.dev/dashboard/activity/filters/)
- [Token-scoped history](https://docs.macrocontent.dev/dashboard/activity/token-history/)
- [Asset library](https://docs.macrocontent.dev/dashboard/assets/)
- [Folders & delete modes](https://docs.macrocontent.dev/dashboard/assets/folders/)
- [Storage & quotas](https://docs.macrocontent.dev/dashboard/assets/storage/)
- [Library vs website](https://docs.macrocontent.dev/dashboard/components/)
- [Assign & activate](https://docs.macrocontent.dev/dashboard/components/assign/)
- [Browse Store](https://docs.macrocontent.dev/dashboard/components/store/)
- [Collaborators](https://docs.macrocontent.dev/dashboard/team/)
- [Content editors](https://docs.macrocontent.dev/dashboard/users/)
- [Role presets & capabilities](https://docs.macrocontent.dev/dashboard/roles/)
- [Ownership transfer](https://docs.macrocontent.dev/dashboard/ownership/)
- [Inbox](https://docs.macrocontent.dev/dashboard/inbox/)
- [Domains overview](https://docs.macrocontent.dev/dashboard/domains/)
- [Add, probe & DNS](https://docs.macrocontent.dev/dashboard/domains/probe/)
- [Branding & attribution](https://docs.macrocontent.dev/dashboard/domains/branding/)
- [SDK keys](https://docs.macrocontent.dev/dashboard/sdk-keys/)
- [API tokens](https://docs.macrocontent.dev/dashboard/api-tokens/)
- [Export & exit](https://docs.macrocontent.dev/dashboard/export/)
- [Languages](https://docs.macrocontent.dev/dashboard/languages/)
- [Danger zone](https://docs.macrocontent.dev/dashboard/danger/)
- [My Account](https://docs.macrocontent.dev/dashboard/account/)
- [Overview](https://docs.macrocontent.dev/store/)
- [Browse & search](https://docs.macrocontent.dev/store/browse/)
- [Claim vs purchase](https://docs.macrocontent.dev/store/claim/)
- [Wishlist](https://docs.macrocontent.dev/store/wishlist/)
- [My components](https://docs.macrocontent.dev/store/library/)
- [Adopt a release](https://docs.macrocontent.dev/store/adopt/)
- [Install on a website](https://docs.macrocontent.dev/store/install/)
- [Presentation for buyers](https://docs.macrocontent.dev/store/presentation/)
- [Macro Score for buyers](https://docs.macrocontent.dev/store/macro-score/)
- [Overview](https://docs.macrocontent.dev/editors/)
- [Open the overlay](https://docs.macrocontent.dev/editors/overlay/)
- [Primitives vs components](https://docs.macrocontent.dev/editors/primitives/)
- [Rich text & links](https://docs.macrocontent.dev/editors/richtext/)
- [Form fields](https://docs.macrocontent.dev/editors/forms/)
- [Assets in the overlay](https://docs.macrocontent.dev/editors/assets/)
- [Locales](https://docs.macrocontent.dev/editors/locales/)
- [SEO fields](https://docs.macrocontent.dev/editors/seo/)
- [Draft vs live](https://docs.macrocontent.dev/editors/publishing/)
- [Publish & keepAlive](https://docs.macrocontent.dev/editors/publishing/keepalive/)
- [Quick Edit live](https://docs.macrocontent.dev/editors/publishing/quick-edit/)
- [History & snapshots](https://docs.macrocontent.dev/editors/history/)
- [What your role can do](https://docs.macrocontent.dev/editors/roles/)
- [Node permissions](https://docs.macrocontent.dev/editors/permissions/)
- [Overview](https://docs.macrocontent.dev/publishers/)
- [Onboarding & profile](https://docs.macrocontent.dev/publishers/onboarding/)
- [Connect onboarding](https://docs.macrocontent.dev/publishers/payouts/)
- [Disconnect & fees](https://docs.macrocontent.dev/publishers/payouts/disconnect/)
- [Listings wizard](https://docs.macrocontent.dev/publishers/listings/)
- [Presentation](https://docs.macrocontent.dev/publishers/presentation/)
- [How to build components](https://docs.macrocontent.dev/publishers/building/)
- [Bundles & Macro Score](https://docs.macrocontent.dev/publishers/bundles/)
- [Releases & updates](https://docs.macrocontent.dev/publishers/releases/)
- [Quality handbook](https://docs.macrocontent.dev/publishers/quality/)
- [Pricing & offers](https://docs.macrocontent.dev/publishers/pricing/)
- [Sales, revenue & invoices](https://docs.macrocontent.dev/publishers/sales/)
- [Publisher API tokens](https://docs.macrocontent.dev/publishers/api-tokens/)
- [Close, transfer, disconnect](https://docs.macrocontent.dev/publishers/lifecycle/)
- [Overview](https://docs.macrocontent.dev/api/)
- [Authentication](https://docs.macrocontent.dev/api/auth/)
- [Open Swagger UI](https://docs.macrocontent.dev/api/swagger/)
- [Management](https://docs.macrocontent.dev/api/management/)
- [Content](https://docs.macrocontent.dev/api/content/)
- [Store](https://docs.macrocontent.dev/api/store/)
- [Publisher](https://docs.macrocontent.dev/api/publisher/)
- [Recipes overview](https://docs.macrocontent.dev/api/recipes/)
- [Publish draft with mt_](https://docs.macrocontent.dev/api/recipes/publish/)
- [Rotate management token](https://docs.macrocontent.dev/api/recipes/rotate-token/)
- [Validate listing in CI](https://docs.macrocontent.dev/api/recipes/validate-listing/)
- [Install component on website](https://docs.macrocontent.dev/api/recipes/install-component/)
- [Platform (dev)](https://docs.macrocontent.dev/api/platform/)

## Related discovery

- [Agent skills index](https://macrocontent.dev/.well-known/agent-skills/index.json)
- [Docs sitemap](https://docs.macrocontent.dev/sitemap.xml)
- [Docs robots](https://docs.macrocontent.dev/robots.txt)
- [npm @macrocontent/sdk](https://www.npmjs.com/package/@macrocontent/sdk)
- [npm @macrocontent/overlay](https://www.npmjs.com/package/@macrocontent/overlay)