diff --git a/packages/grafana-ui/src/components/ColorPicker/ColorPicker.story.mdx b/packages/grafana-ui/src/components/ColorPicker/ColorPicker.story.mdx
new file mode 100644
index 00000000000..71a7c29a8d0
--- /dev/null
+++ b/packages/grafana-ui/src/components/ColorPicker/ColorPicker.story.mdx
@@ -0,0 +1,11 @@
+import { Meta } from '@storybook/addon-docs/blocks';
+
+<Meta title="General/ColorPicker/ColorPicker"/>
+
+# ColorPicker
+
+The `ColorPicker` component group consists of several building blocks that are combined in Grafana to create the `ColorPicker`: popover, pickers and palettes. There are different combinations of these building blocks depending on where the `ColorPicker` is used in Grafana.
+
+The `Popover` is a tabbed view where you can switch between `Palettes`. The `NamedColorsPalette` shows an arrangement of  preset colors, while the `SpectrumPalette` is an unlimited HSB color picker. The preset colors are opimized to work well with both light and dark theme. `Popover` is triggered for example by the series legend of graphs, or by `Pickers`.
+
+The `Pickers` are single circular color fields that show the currently picked color. On click, they open the `Popover`.