diff --git a/docs/snippets/react/button-story-project-args-theme.js.mdx b/docs/snippets/react/button-story-project-args-theme.js.mdx
new file mode 100644
index 00000000000..da897c5a782
--- /dev/null
+++ b/docs/snippets/react/button-story-project-args-theme.js.mdx
@@ -0,0 +1,9 @@
+```js
+// preview.js
+
+// All stories expect a theme arg
+export const argTypes = { theme: { control: { options: ['light', 'dark'] } } };
+
+// The default value of the theme arg to all stories
+export const args = { theme: 'light' };
+```
diff --git a/docs/writing-stories/args.md b/docs/writing-stories/args.md
index 522d01702e8..4b8976ca7e9 100644
--- a/docs/writing-stories/args.md
+++ b/docs/writing-stories/args.md
@@ -10,7 +10,7 @@ Learn how and why to write stories in [the introduction](./introduction.md#using
 
 ## Args object
 
-The `args` object can be defined at the [story](#story-args) and [component level](#component-args). It is a JSON serializable object composed of string keys with matching valid value types that can be passed into a component for your framework.
+The `args` object can be defined at the [story](#story-args), [component](#component-args) and [project level](#project-args). It is a JSON serializable object composed of string keys with matching valid value types that can be passed into a component for your framework.
 
 ## Story args
 
@@ -76,6 +76,20 @@ You can also define args at the component level; they will apply to all the comp
 
 <!-- prettier-ignore-end -->
 
+## Project args
+
+You can also define args at the project level; they will apply to every component's stories unless you overwrite them. To do so, export the `args` key in your `preview.js`:
+
+<!-- prettier-ignore-start -->
+
+<CodeSnippets
+  paths={[
+    'react/button-story-project-args-theme.js.mdx',
+  ]}
+/>
+
+<!-- prettier-ignore-end -->
+
 ## Args composition
 
 You can separate the arguments to a story to compose in other stories. Here's how you can combine args for multiple stories of the same component.