Home›Editing Content
02

Editing Content

Learn how to edit sections, subsections, and content in Form mode — including Document Info and auto subsection TOC.

Adding a New Section

Learn how to create a new section file.

  1. Click the + button
    Click the "+" button at the top of the sidebar.
  2. Enter Section Information
    Enter the following information in the modal:
    • Order: Numbers only (e.g., "3" → number becomes 03 automatically)
    • Document Info (unnumbered): Check for release notes, legal notices, etc.
    • Slug: Lowercase letters, numbers, and hyphens only (e.g., "new-feature")
    • Title: Enter multilingual title
  3. Creation Complete
    Click the ✅ button to create the new section file, which will be automatically selected.

Adding a Subsection

Learn how to add a subsection within a section.

  1. Click the + Add Subsection button
    In Form mode, click the "+ Add Subsection" button.
  2. Enter Subsection Information
    Enter the following information for the subsection:
    • ID: Unique identifier (e.g., "feature-overview")
    • Title: Multilingual title
    • Description: Multilingual description (optional)

Adding Content

Learn how to add Step Guide, InfoBox, Screenshot, and Table to subsections.

Content Types
Manual Editor supports the following 4 content types: 1. Step Guide: Step-by-step guide (can include images) 2. InfoBox: Information box (info, warning, tip, danger) 3. Screenshot: Screenshot image 4. Table: Table (manualTable)
  1. Expand Subsection
    Click on the subsection to expand it where you want to add content.
  2. Select Content Type
    Click the "+ Add Content" button and select the desired content type.
  3. Edit Content
    Enter the fields according to the selected content type.

Reordering with Drag and Drop

You can reorder subsections and content by dragging and dropping.

  1. Drag Item
    Click and drag the subsection or content item you want to move.
  2. Drop at Target Location
    Drag to the desired location and release the mouse to change the order.

Document Information Area

Use the Document Information area for release notes, legal notices, and open-source licenses. It appears below the Table of Contents on the product cover, without section numbers.

  1. Open a section file (not _product.yaml)
    Document Info is not configured in _product.yaml. Create or open a section YAML file (e.g., 90-release-notes.yaml, 08-reference.yaml).
  2. Enable Document Info (unnumbered)
    In Form mode, open Section Info and check Document Info (unnumbered). Or in YAML mode, set: ``yaml section: number: "" slug: release-notes order: 90 unnumbered: true title: ko: 릴리즈 노트 en: Release Notes ``
  3. Check the product cover preview
    After save and Sanity sync, the section appears under Document Information on the product cover (below Contents), without a number badge. Numbered chapters stay under Contents; unnumbered sections move to Document Information.
Tips
  • Select _product.yaml in the sidebar to preview the cover (Contents + Document Information).
  • Existing sections like "Reference / Legal Notice" can be moved by enabling Document Info (unnumbered) on that section file.
  • Order still controls sort order; only the number display is hidden.

Auto Subsection Table of Contents

When a section has 3 or more subsections, a title-link TOC is generated automatically at the top of the section page.

How it works
Behavior
  • Shown only when there are 3 or more subsections
  • Lists subsection titles as in-page links
  • Clicking a link scrolls to that subsection (#id)
  • No manual TOC editing required — titles come from each subsection
Editor tip: Fill in each subsection ID (e.g., feature-overview). The ID is used as the anchor for the link.
Note
With fewer than 3 subsections, the TOC is hidden so short sections stay uncluttered.