---
title: Stories
description: Stories are pieces of content, similar to documents on a computer.
url: https://storyblok.com/docs/manuals/stories
---

# Stories

In Storyblok, a story is a way to store information. Each story represents a unique piece of content or knowledge, like an article, a landing page, or a configuration file — similar to a document on a computer.

> [!NOTE]
> Edit and publish
> 
> Want to learn how to create, edit, and publish stories? Dive into the [Visual Editor](/docs/manuals/visual-editor).

## Template

Stories are made up of **blocks**. A block could be any piece of information — some text, an image, a banner, or even a group of more blocks. The developer who configures Storyblok can design custom block types to use in your story.

Each story is based on a template, called a **content type**. The developer who sets up Storyblok can mix and match blocks to create content types for different types of stories.

Content types are typically designed in collaboration between developers, designers, and editors.

> [!TIP]
> **The anatomy of a story**
> 
> Under the hood, a story is actually a type of block. For example, the `home` story (included in blank and core blueprint spaces) is created from a content type called `page`. Together, stories and blocks form versatile content compositions that support endless combinations based on the website's structure.
> 
> If your main job is to edit content, then you probably don’t need to know much about how to configure blocks — that’s a job for developers — but if you’re curious you can learn more in our [developer documentation on blocks](https://www.storyblok.com/docs/concepts/blocks).

## Create

To create a new story, open the **Content** tab, click **\+ Create new**, and choose **Story**. The **New Story** window will prompt you to input some details about your story, including the **Content type**. The content type is the format of the story, like “blog post” or “conference speaker.”

To duplicate a story, select the story’s checkbox and click **Duplicate** in the toolbar. Since each story must have a unique slug, you must either edit the duplicate’s slug or place the duplicate in a different folder. When duplicating stories in bulk, you cannot edit the duplicate’s slug, so you must place the duplicates in a different folder or else duplicate stories one by one.

## Browse

To see all the stories in a space, open the **Content** tab.

The content tab lets you search, filter, and sort stories; organize them with folders and tags; and mark them as favorites.

Use the **Search** bar to find stories by name, slug, or content type. Start typing to view content that matches the search term.

> [!NOTE]
> To perform a programmatic [search in stories](https://www.storyblok.com/docs/api/content-delivery/v2/stories/retrieve-multiple-stories), use the Content Delivery API's `search_term` query parameter. For more advanced search capabilities, integrate third-party providers or Storyblok's [Algolia plugin](https://www.storyblok.com/apps/storyblok-gmbh@algolia).

Use the **Filter** dropdown menu to perform an advanced search. Select one or more filters and create queries to display results based on the relevant criteria. Save combinations of filters for quick access or copy the URL to share filtered views with other users. Use **Contains Content Item** to filter for stories that link to a given story. (Filtering by linked story only applies to stories in the same folder or the root folder.)

Use the **Sort** dropdown menu to reorder displayed stories by dates, names, or slugs.

Use the **Favorite** button at the rightmost end of each row to mark a story for quick access. Click the **Favorites** button at the top to display only those stories.

> [!TIP]
> To move stories to the trash instead of permanently deleting them, install the [Trash bin app](https://www.storyblok.com/apps/trashcan). Then, select the **Deleted content** button at the top-right and restore deleted items (including those deleted before installing the app).

## Organize

Folders and tags complement each other and help editors manage content internally while serving as navigational aids for website visitors.

Folders and tags are subtly different in their functions as content taxonomies: Folders provide hierarchy and can be nested. This is common in multilingual websites, for example, where the top-level folders are the languages, and the subfolders are content categories (blog, team, etc.).

Tags, on the other hand, help create thematic associations by grouping stories across folders. An e-commerce site, for example, might have many product-type stories tagged "Sale" in any number of product category folders.

To organize multiple stories, select them by their checkboxes and choose an action from the toolbar. Select all visible stories by clicking the checkbox at the top of the list.

> [!TIP]
> Learn more about [content architecture](https://www.storyblok.com/mp/content-architecture) and how it can improve workflows and user experience (UX).

### Folders

To move a story into a folder, check the story’s checkbox, choose **Settings** from the toolbar, and change the **Parent folder**.

To move one or more stories into a folder, select them, choose **Move** from the top toolbar, open the destination folder, and click the insert icon in the destination.

> [!WARNING]
> Moving stories in the **Content** tab affects more than their display order and may lead to unexpected behavior on the frontend. Consult your development team before making any changes. To adjust the order in which the stories are displayed, use the **Sort** dropdown menu.

To create a new folder, click **\+ Create new**, then **Folder**.

To reveal the folder actions toolbar, check a folder’s checkbox.

### Tags

To tag a story, check the story’s checkbox and click **Tag** in the toolbar.

To view tagged stories, click the **Content Type** column header, then **Tag List**.

To manage tags, open the **Tags** tab. Here, you can create new tags, rename existing tags, add and remove tags from stories, and delete tags. To view all stories with a given tag, hover over the tag and click the view icon.

### References

Depending on your Storyblok configuration, you might be able to filter the stories in a folder based on references to other stories. For example: filter blog posts based on their author, or filter landing pages by CTA.

To filter stories that reference a given story, select **Filters** → **Contains Content Item** and apply the filter. Then, in the **Filter** → **Contains Content Item** dropdown, pick the stories and select **Done**.

## Pagination

-   [Previous: Spaces](/docs/manuals/spaces)
-   [Next: Technical Requirements](/docs/manuals/technical-requirements)