diff --git a/docs/api/main.js configuration/main-config-indexers.mdx b/docs/api/main.js configuration/main-config-indexers.mdx
index c8c2a650876c..1e17d22829be 100644
--- a/docs/api/main.js configuration/main-config-indexers.mdx	
+++ b/docs/api/main.js configuration/main-config-indexers.mdx	
@@ -196,13 +196,13 @@ Transpiling the custom source format to CSF is beyond the scope of this document
 
 The general architecture looks something like this:
 
-![Architecture diagram showing how a custom indexer indexes stories from a source file](./main-config-indexers-arch-indexer.jpg)
+![Architecture diagram showing how a custom indexer indexes stories from a source file](../../_assets/api/main-config-indexers-arch-indexer.jpg)
 
 1. Using the [`stories`](./main-config-stories.md) configuration, Storybook finds all files that match the [`test`](#test) property of your indexer
 2. Storybook passes each matching file to your indexer's [`createIndex` function](#createindex), which uses the file contents to generate and return a list of index entries (stories) to add to the index
 3. The index populates the sidebar in the Storybook UI
 
-![Architecture diagram showing how a build plugin transforms a source file into CSF](./main-config-indexers-arch-build-plugin.jpg)
+![Architecture diagram showing how a build plugin transforms a source file into CSF](../../_assets/api/main-config-indexers-arch-build-plugin.jpg)
 
 4. In the Storybook UI, the user navigates to a URL matching the story id and the browser requests the CSF file specified by the [`importPath`](#importpath) property of the index entry
 5. Back on the server, your builder plugin transpiles the source file to CSF, and serves it to the client
diff --git a/docs/essentials/themes.mdx b/docs/essentials/themes.mdx
index 7c68bc0bfcb3..372095ddea8a 100644
--- a/docs/essentials/themes.mdx
+++ b/docs/essentials/themes.mdx
@@ -8,7 +8,7 @@ sidebar:
 
 Storybook's [Themes](https://github.com/storybookjs/storybook/tree/next/code/addons/themes) addon allows you to switch between multiple themes for your components inside of the preview in [Storybook](https://storybook.js.org).
 
-![Switching between themes in Storybook](./addon-themes-example.gif)
+![Switching between themes in Storybook](../_assets/essentials/addon-themes-example.gif)
 
 ## Theme decorators
 
diff --git a/docs/sharing/design-integrations.mdx b/docs/sharing/design-integrations.mdx
index e8f635729529..f3f894887aff 100644
--- a/docs/sharing/design-integrations.mdx
+++ b/docs/sharing/design-integrations.mdx
@@ -118,7 +118,7 @@ Zeplin's native app also supports [links to published Storybooks](https://suppor
 
 Zeroheight integrates with [Storybook](https://zeroheight.com/3xlwst8/p/507ba7-storybook), enabling you to embed stories alongside your design specs.
 
-![Zeroheight Storybook integration](./storybook-zeroheight.gif)
+![Zeroheight Storybook integration](../_assets/sharing/storybook-zeroheight.gif)
 
 ## UXPin
 
@@ -136,7 +136,7 @@ UXPin allows you to [use interactive stories](https://www.uxpin.com/docs/merge/s
 
 InVision allows you to embed [Storybook](https://support.invisionapp.com/hc/en-us/articles/360028388192-Publishing-Storybook-to-DSM) in your design system documentation.
 
-![Invision DSM Storybook integration](./storybook-invision-dsm.gif)
+![Invision DSM Storybook integration](../_assets/sharing/storybook-invision-dsm.gif)
 
 ## Adobe XD