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.

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.

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.

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. 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 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 multiple stories into a folder, check their checkboxes, choose Move from the top toolbar, open the destination folder, and click the insert icon in the destination.

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.