Global Reusable Content

Enterprise Groups support Reusable Content and Custom Components at the group level. Global versions of both are available across every project in the group. You can author once, and reuse everywhere. Both can also be created at the project level, where they're scoped to that project only.

Learn about Project Reusable Content.

Reusable Content

Reusable Content blocks are sections of Markdown text that you write once and can insert across multiple pages. At the group level, a Global Reusable Content block is available in any page across all projects in the group.

Enterprise Group Admins can access Global Reusable Content from the Reusable Content page in the Enterprise Group dashboard sidebar. The left column lists all global blocks by name, with a text preview and last-edited timestamp. Click a block to open its full Markdown content and see where it's used across pages and projects.

Edit Reusable Content

Only Enterprise Group Admins can edit global blocks. When a global block is updated, changes automatically propagate to every instance across all child projects.

When a Project Admin opens the < menu in a project editor, the Reusable Content list shows both global and project-level blocks. Global blocks are marked with the Global Reusable label.

Project Admins without Enterprise Group Admin permissions can insert global blocks but can't edit them. A banner in the editor indicates the block is read-only.

📘
You can detach a global block to edit it in isolation. A detached block is no longer linked to the global version and changes won't propagate.

Custom Components

Custom Components are interactive, visually rich elements like buttons, banners, and graphs that can be added to any Guides or API Reference page. Global Custom Components can only be created at the Enterprise Group level, but are available across all child projects.

Enterprise Group Admins can access Global Custom Components from the Custom Components page in the Group dashboard sidebar. From there, you can create, rename, and delete components.

Edit Custom Components

Only Enterprise Group Admins can edit Global Custom Components. Updates made from the dashboard automatically propagate across all instances where the component is used.

📘
Deleting Global Components
You can't delete a Global Custom Component that's currently in use. First remove it from all projects where in use, then return to the Group Dashboard to delete it.

If a Global Custom Component shares a name with a project-level component, the child project always uses the project-level version.

Learn about Project Reusable Content.