Stories

In Storyblok, a story is a way to store information. Each story represents a unique piece of content or configuration, like an article, a landing page, or even a navigation menu.

Template

Stories are made up of blocks. A block could be any piece of information: text, an image, a banner, or even a group of blocks. The development team creates custom block types depending on the content team's needs and business requirements.

Each story is based on a template, called a content type. Developers can mix and match blocks to create content types for different types of stories, such as blogs, products, authors, and more.

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

Create

To create a new story, open the Content section, select + Create new, and choose Story. The New Story window prompts you to input details, including the Slug and Content type. Think of the content type as the template of the story, like “blog post” or “conference speaker.”

To duplicate a story, select it and choose Duplicate from 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 can't edit the slugs, so you must place the duplicates in a different folder.

Browse

To view all the stories in a space, open the Content section. You can search, filter, and sort stories; organize them with folders and tags; and mark them as favorites.

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

To find an exact search string that appears inside a story, wrap the search query in double quotes ("exact search").

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 teammates.

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 landing pages by call to action.

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

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

To mark a story for quick access, use the Favorite button at the rightmost end of each row. To display only those stories, select Favorites.

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 website, for example, might have many product-type stories tagged "Sale" in any number of product category folders.

To organize multiple stories, select them and choose an action from the toolbar. To select all visible stories, choose the topmost checkbox.

Folders

Move a single story: to move a story into a folder, select the story, choose Settings from the toolbar, and change the Parent folder.
Move multiple stories: to move two or more stories into a folder, select them, choose Move from the toolbar, open the destination folder, and select Move.

To create a new folder, select + Create new, then Folder.