---
title: Visual Editor
description: The Visual Editor is the interface for your content in Storyblok. It gives you tools for writing, editing, arranging, and managing your content.
url: https://www.storyblok.com/docs/manuals/visual-editor
---

# Visual Editor

The Visual Editor is the interface for your content in Storyblok. It gives you tools for writing, editing, arranging, and managing your content.

Select any story from the **Content** section of your space and open it in the Visual Editor.

> [!TIP]
> Learn what [stories](/docs/manuals/stories) are and how to manage them, or follow the [Visual Editor developer concept](https://www.storyblok.com/docs/concepts/visual-editor) to configure the editor in your codebase.

## Preview mode

In the left toolbar, the **Form/Visual** button hides and reveals a visual preview of your website. The preview shows a draft rendering of your website. The preview also includes context menus with editing controls when you hover over blocks. To edit a block's contents, select it from the preview.

[![The Visual Editor has two sections: the editing sidebar on the right and the rendered content and design on the left.](https://a.storyblok.com/f/212319/3024x1714/71b699f173/editor-preview.png/m/720x0/)](https://a.storyblok.com/f/212319/3024x1714/71b699f173/editor-preview.png)

A preview rendered in the Visual Editor

To preview your content at different screen sizes, select **Desktop**, **Mobile**, or **Full-width** in the top toolbar.

To open a standalone preview in a new tab, select **Open preview** in the top toolbar.

### Form view

The **Form** view displays a group of input fields for your content. The order of fields depends on the structure set up by your developer.

Create and edit your content in the form fields, preview the result, and save the changes.

## Blocks

The input fields support many types of content, but there's one type of field that is more capable than others: the [blocks field](https://www.storyblok.com/docs/concepts/fields#blocks).

A block is a piece of content, usually a few fields that work together to compose a larger element, like a grid of product cards or an image gallery.

[![Edit a block named Headline Segment inside Storyblok's Visual Editor. Selecting the block opens a pop-up menu with additional options, like duplicating, deleting, or copying the block.](https://a.storyblok.com/f/212319/3024x1714/e8502403aa/visual-editor-blocks.png/m/720x0/)](https://a.storyblok.com/f/212319/3024x1714/e8502403aa/visual-editor-blocks.png)

Edit a block in the Visual Editor

A blocks field typically makes up the main body of a story. For example, a blog post might have a “Body” field that can contain “Rich Text”, “Image”, and “Author” blocks. Editors can add, delete, and rearrange these blocks to compose content.

To add a block into a blocks field, hover over the top border, choose **Add Block**, and select the block from the popover sidebar.

### Presets

Presets are blocks that come pre-filled with content. Admin users can create presets and define their content.

To create a preset of an existing block, select the **Block actions** menu to the right of the block’s name, choose **Open Presets**, and add a new preset. To illustrate the preset, upload a screenshot. **Save**, then open the new preset, and select **Fill preset with current content**.

To set a specific preset as the default state for new blocks, open the **Presets** tab of the block editor and choose **Mark as Default** for the relevant preset.

## Rich text editor

A story can have any number of [rich text fields](https://www.storyblok.com/docs/concepts/fields#rich-text) with different configurations. The editor supports many types of content:

-   Headings
-   Bullet and numbered lists
-   Links
-   Emojis
-   Tables
-   Images
-   Code blocks
-   Blocks
-   Horizontal rules

Use the rich text editor’s toolbar to format text and insert elements.

> [!TIP]
> The rich text editor supports Markdown. For example, to create headings, add 1-6 `#` signs at the beginning of the line (`## Heading`). To mark a word bold, surround it with two asterisks (`**Bold**`).

Depending on your configuration, you might be able to insert other blocks into a rich text field: select **Add block** in the toolbar.

### Rich text editor theme switcher

The rich text editor toolbar includes a background color switcher that applies only to the editing environment: select **Change RTE background** **color** choose a color, and **Apply**.

[![A rich text field in the Visual Editor, displaying the Change RTE background color option](https://a.storyblok.com/f/212319/2999x1370/34630156b2/theme-switcher-rte.png/m/720x0/)](https://a.storyblok.com/f/212319/2999x1370/34630156b2/theme-switcher-rte.png)

A background color applied to the rich text editor

## Links

An internal link defines a relationship to another piece of content without manually writing a URL. To create an internal link, open a link field (that has internal linking enabled) and use the folder browser or search bar to find the appropriate story.

To edit the linked story, select **Stack view**, and view the linked story in a floating editor. Make changes, save, and click anywhere outside the window to return to the original story. To open the linked story in the main editor, select **Open**.

### Anchors

An anchor is a unique ID marked with a hash sign (`#`), which you can link to from any story. Anchor links are useful when you want to link directly to a specific section within a story.

First, create an anchor in the story to which you link: in a rich text field, select an anchor position, and then select **Set anchor** from the toolbar. Specify the word that serves as an anchor. Back in the original story, create an internal link as explained above, and select **Define the anchor ID of the link**. Finally, provide the same word you specified before. For example, `my-anchor`.

## The Sidebars

The editor is framed by two sidebars: the one on the right contains additional [content authoring](/docs/manuals/content-authoring), collaboration, and integration features. The one the left features quick links to other sections, and story-focused utilities.

### Story settings

To edit the story settings—such as the name, slug, tags, or date—open **Config** in the right toolbar.

The story's slug is a unique ID used to define this web page's URL, together with the folder name and website domain. For example, `https://www.storyblok.com/docs/manuals/visual-editor`.

### Comments

Use comments to start discussions with team members or leave notes for yourself.

Every field in the Visual Editor has a comment button, which opens a new discussion. To add a comment, select **Start a discussion** next to the field. To tag teammates, type `@` followed by their name. Tagged users receive an email notification with a link to the comment.

[![A discussion modal over a rich text field.](https://a.storyblok.com/f/212319/3024x1714/c1533e65c8/visual-editor-comments.png/m/720x0/)](https://a.storyblok.com/f/212319/3024x1714/c1533e65c8/visual-editor-comments.png)

A discussion in the Visual Editor

To review all discussions in a story, open **Comments** in the right toolbar. Select a comment to read, reply, or resolve. The **Resolved** tab lists all resolved comments chronologically.

To view all your replies and mentions, open the space **Dashboard** and select **My Mentions**.

### The left toolbar

The left toolbar contains additional utilities (depending on your user role):

-   **Layers:** an outline of the blocks in the current story.
-   **Content:** search through the stories in the space.
-   **Blocks:** view all available blocks.

The **More** menu lists links to other sections of the space: **Assets**, **Datasources**, **Tags**, **Apps**, and **Settings**.

### Keyboard shortcuts

Use keyboard shortcuts for frequent actions, including saving and publishing stories, toggling the language selector, and more. All available shortcuts are visible in the left toolbar, under **Keyboard shortcuts**. To learn more about navigating Storyblok using a keyboard, read [the announcement blog post](https://www.storyblok.com/mp/announcing-improved-keyboard-navigation).

## Story status

A story’s status determines its visibility to website visitors, crawlers, and so on. Stories have three states:

-   **Draft or unpublished:** gray dashes indicate that the story is _unpublished_. This story appears only in the preview versions of the website.
-   **Published:** solid green indicates that the story is _published_. This story is accessible to website visitors.
-   **Changed:** green dashes indicate that the story is _published and changed_. Until you republish, the changes appear only in the preview versions of the website.
-   **Scheduled:** blue indicates a scheduled story. The shape and fill change depending on the publication status and date.

In the Visual Editor, the status indicator appears next to the **Save** button. It's also visible in the **Content** section:

[![Storyblok content section showing a list of stories with their matching publication status icons.](https://a.storyblok.com/f/212319/2880x1604/0a36e1786f/content-section-story-status.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1604/0a36e1786f/content-section-story-status.png)

The **Content** section, showing stories in different statuses

### Schedule story publication

You can schedule a new draft or updates to a published story to publish automatically at a later date.

> [!NOTE]
> Scheduled publication is only available on specific plans. Learn more on the [pricing page](https://www.storyblok.com/pricing).

To schedule a story, open it in the Visual Editor, select **More options** (next to **Publish**), and choose **Schedule publishing**.

Set the date, time, and timezone (defaults to your account setting). Once you select **Schedule**, **Publish** changes to **Save scheduled changes**, and Storyblok adds any saved changes to the scheduled story.

To view, reschedule, or delete an upcoming schedule, open **Info** in the toolbar. Alternatively, select **More options** for related settings:

-   **Edit scheduled publishing** to reschedule.
-   **Publish now** to publish immediately and clear the automatic schedule.

#### Schedule multiple languages

In multilingual projects that enable [individual translation publishing](/docs/manuals/translations), you can set a separate schedule for language versions.

Open a story that has multiple translations, select one or more languages from the **Languages** menu, and choose **Schedule**.

## Advanced usage

The Visual Editor has deep integrations with the rest of the Storyblok ecosystem. Learn how to use Storyblok's features to enhance your content management:

-   [History](/docs/manuals/history): track changes to content over time.
-   [Ideas](/docs/manuals/ideation-room): brainstorm new content.
-   [Assets](/docs/manuals/assets): upload and manage files in your space.
-   [Image Editor](/docs/manuals/image-editor): edit your images within Storyblok.
-   [Experiments](/docs/manuals/experiments): run A/B tests on different versions of the same story.

## Pagination

-   [Previous: Translations](/docs/manuals/translations)
-   [Next: Workflows](/docs/manuals/workflows)
