> ## Documentation Index
> Fetch the complete documentation index at: https://weaverse.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Weaverse component configuration uses `settings`. `inspector` is deprecated; never generate it.
> Weaverse Hydrogen themes use React Router v7: import from `react-router`, never `react-router-dom` or `@remix-run/*`.
> Before using any code sample, read `@weaverse/hydrogen` in the project's `package.json`: 6.x and 5.x import from different entries and use different type names, so code for one does not build on the other.
> `@weaverse/hydrogen` 6 (Shopify Hydrogen 2026.10 and later, the version these docs show) imports from `@weaverse/hydrogen/react-router` and uses `Weaverse*` types such as `WeaverseComponentProps`, `WeaverseComponentLoaderArgs` and `WeaverseComponentSchema`; the root `@weaverse/hydrogen` entry only exports `createSchema()`, data helpers and types.
> `@weaverse/hydrogen` 5.x (Hydrogen 2026.4 and earlier) imports everything from `@weaverse/hydrogen` and uses `HydrogenComponentProps`, `ComponentLoaderArgs` and `HydrogenComponentSchema`. On a 5.x project, convert samples to these names. Upgrade to 6 only when asked (`npx @weaverse/cli@latest migrate v6`, plus the Hydrogen 2026.10 upgrade). Do not mix major versions.
> Next.js themes use `@weaverse/hydrogen` 6.2.0 or later: import client and shared code from `@weaverse/hydrogen/next` and server-only code from `@weaverse/hydrogen/next/server`. `@weaverse/next` is deprecated; never install or import it.
> For live project data (pages, theme settings, translations), use the Weaverse MCP server: https://weaverse.io/docs/developer-tools/weaverse-mcp

# Navigating Weaverse Studio

> Understand the main areas of Weaverse Studio so you can edit pages, preview storefront changes, and manage project settings efficiently.

Weaverse Studio is the visual workspace for building and customizing Shopify Hydrogen storefronts. The editor is organized around a page selector, a page outline, a live preview canvas, an inspector, and project-level settings.

![Weaverse Studio interface with page outline, storefront preview, and section settings](https://mintcdn.com/weaverse/6CZovEr06L6Ob7kB/images/studio-guide/interface-tour-overview.png?fit=max\&auto=format\&n=6CZovEr06L6Ob7kB\&q=85\&s=cad17cfa8fb95f7067ea6cf6e22424a0)

## Top Bar: Page and Store Context

The top bar helps you choose what you are editing and which storefront context you are previewing.

* **Page search and selector:** Find the page you want to edit. Pages are grouped by type, such as Homepage, Product pages, Collection pages, standard Pages, and Custom Pages.
* **Locale or language controls:** If your project supports multiple locales or the Translation Manager, use these controls to switch language context or open translation workflows.
* **Store URL tabs:** Switch between configured storefront URLs when a project has multiple preview contexts.
* **Save or publish action:** Save the current page changes so they can be used by the connected storefront.

## Left Sidebar: Outline, Sections, and History

The left sidebar shows the structure and editing history for the current page.

![Weaverse Studio Page Outline](https://cdn.shopify.com/s/files/1/0838/0052/3057/files/pageoutline.webp?v=1743413723)

* **Page Outline:** A tree view of the sections, blocks, and elements on the page.
* **Selection:** Click an item in the outline to highlight it on the canvas and open its settings in the Inspector.
* **Reordering:** Drag items in the outline to change their order on the page.
* **Visibility:** Hide or show a section while working on the page.
* **Delete:** Remove a section or element from the page.
* **Add Section:** Open the component library and add a new section from the components registered in your Hydrogen theme.
* **Version History:** Review previous saved versions and restore content when needed.

## Preview Canvas

The canvas is the live, interactive preview of the page you are editing. Click a visible section on the canvas to select it, then edit its content, settings, or styles in the Inspector.

The redesigned Studio workspace also includes a browser-style preview bar:

* **Preview URL selector:** Choose or update the storefront URL Studio should load.
* **Preview status:** See whether the local or hosted storefront is connected.
* **Performance signals:** Review inline performance scores when they are available.
* **Responsive preview:** Switch between desktop, tablet, and mobile layouts to check the page at different sizes.

## Right Panel: Inspector

The Inspector panel is where you configure the selected section, block, or element.

![Heading settings in the Weaverse Studio Inspector](https://mintcdn.com/weaverse/6CZovEr06L6Ob7kB/images/studio-guide/heading-inspector-settings.png?fit=max\&auto=format\&n=6CZovEr06L6Ob7kB\&q=85\&s=cd57110bf8a6b30a07365e0112d9aefd)

![Weaverse Studio Theme Settings Inspector](https://cdn.shopify.com/s/files/1/0838/0052/3057/files/theme-setting.webp?v=1743409893)

* **Settings:** Edit component-specific content and behavior. These fields come from the component's `schema.settings` definition, such as text, image, product, collection, layout, and toggle controls.
* **Style:** Adjust visual properties such as spacing, alignment, color, background, borders, and responsive layout options.
* **General:** Use common actions such as visibility, duplicate, and delete.
* **Theme Settings:** Edit global theme settings defined in `~/weaverse/schema.server.ts`, such as brand colors, typography, layout defaults, and reusable theme content.

## Studio Settings

Studio settings are available from the settings popover in the workspace. This popover consolidates project preferences, project details, and recent activity.

![Weaverse Studio Project Settings](https://cdn.shopify.com/s/files/1/0838/0052/3057/files/project-setting.webp?v=1743413912)
![Weaverse Studio Theme Info](https://cdn.shopify.com/s/files/1/0838/0052/3057/files/theme-info.webp?v=1743410159)

* **Preferences:** Manage editor preferences and workspace behavior.
* **Project:** View or update project-level settings, including the **Project ID**. This is the only Studio value a standard Hydrogen setup needs — copy it into your theme's `.env` as `WEAVERSE_PROJECT_ID`.
* **Preview URL:** Configure the storefront URL Studio should load, such as `http://localhost:3456` during local development.
* **Domains:** Configure custom domains when your project uses Weaverse-hosted storefront features.
* **Activity:** Review recent project activity and editing history.
* **Theme:** View theme information such as name, author, and version from `themeSchema.info` in `~/weaverse/schema.server.ts`.

> [!NOTE]
>
> API tokens are not part of this Studio-to-Hydrogen setup. Content API credentials are generated separately (as `content_api` tokens) and are only needed when an external application calls Weaverse's APIs. See [API Access](https://weaverse.io/docs/features/api-access.md).

## Common Editing Flow

1. Select a page from the top bar.
2. Add or select a section from the left sidebar or preview canvas.
3. Edit content and styles in the Inspector.
4. Check desktop, tablet, and mobile previews.
5. Save your changes.

Once you know where these controls live, Weaverse Studio becomes a fast loop: choose a page, edit visually, preview the result, and save.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.