Storybook - Using loaders


Let's take a look at Storybook's loaders and how they work

24 Nov, 2022 ยท 2 min read

Loaders are still an experimental function that can be used to add data for a story, and it's decorators.

The loaders are run before the story renders, and whatever is loaded gets injected into the render context. You can use these loaders to load any asset or even fetch data from an API.

We get two ways of loading that we'll look into, one is for a specific story, and one is for your global system.

Loading data for a story

Let's say we have a specific item that needs rendering instead of mocking the hard-coded data. We can opt to load it from a remote API.

This could be a mock API, as you'll see in the example, or your actual API if it's public data.

Let's take the example of a story that renders a blog item card.

import React from 'react';

import fetch from 'node-fetch';

import { BlogItem } from './BlogItem';

export default {
  title: 'BlogItem'
  component: BlogItem,

export const Primary = (args, { loaded: { blogItem } }) => <BlogItem {...args} {...blogItem} />;
Primary.loaders = [
    async () => ({
      blogItem: await (await fetch('')).json(),

Now our item will load whatever the API returns. This could be useful to try against a vast majority of randomized test items.

Loading global data

In some cases, you might want to prepare a global loader, for instance, a logged-in user attribute.

We can add these loaders into our .storybook/preview.js file like this.

import fetch from 'node-fetch';

export const loaders = [
  async () => ({
    currentUser: await (
      await fetch('')

Now in every story, you can use the loader.currentUser value like this.

export const Primary = (args, { loaded: { currentUser } }) => (
  <BlogItem {...args} {...currentUser} />

Loaders can be a super reliable way to set up reusable data that flows down to the excellent story without you having to do it repeatedly.

Thank you for reading, and let's connect!

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter

Spread the knowledge with fellow developers on Twitter
Tweet this tip
Powered by Webmentions - Learn more

Read next ๐Ÿ“–

Storybook - Additional integrations

29 Nov, 2022 ยท 2 min read

Storybook - Additional integrations

Storybook - Examples

28 Nov, 2022 ยท 2 min read

Storybook - Examples

Join 2103 devs and subscribe to my newsletter