diff --git a/docs/pages/typescript/index.tsx b/docs/pages/typescript/index.tsx
index 5d6d6810fd..97160517c5 100644
--- a/docs/pages/typescript/index.tsx
+++ b/docs/pages/typescript/index.tsx
@@ -85,6 +85,24 @@ const onChange = (option: readonly Option[], actionMeta: ActionMeta<Option>) =>
 ~~~
 
 The \`actionMeta\` parameter is optional. \`ActionMeta\` is a union that is discriminated on the \`action\` type. Take a look at at [types.ts](https://github.com/JedWatson/react-select/blob/master/packages/react-select/src/types.ts) in the source code to see its full definition.
+
+## Custom Select props
+
+You can use module augmentation to add custom props to the \`Select\` prop types:
+
+~~~jsx
+declare module 'react-select/dist/declarations/src/Select' {
+  export interface Props<
+    Option,
+    IsMulti extends boolean,
+    Group extends GroupBase<Option>
+  > {
+    myCustomProp: string;
+  }
+}
+~~~
+
+This will make the custom prop available both when using the \`Select\` component as well as when accessing \`selectProps\` when [customizing components](./components).
       `}
     </>
   );
diff --git a/docs/pages/upgrade/index.tsx b/docs/pages/upgrade/index.tsx
index 38853dafe3..d3cf505974 100644
--- a/docs/pages/upgrade/index.tsx
+++ b/docs/pages/upgrade/index.tsx
@@ -52,6 +52,20 @@ import { ... } from 'react-select/dist/declarations/src/...';
 
 We export any types from the main entry point that we think might be useful to the user. If you are using a type that is not exported from the main entry point please open a PR or issue so that we can add it.
 
+If you are using custom props for the \`Select\` component you can use module augmentation to add them to the \`Select\` prop types:
+
+~~~jsx
+declare module 'react-select/dist/declarations/src/Select' {
+  export interface Props<
+    Option,
+    IsMulti extends boolean,
+    Group extends GroupBase<Option>
+  > {
+    myCustomProp: string;
+  }
+}
+~~~
+
 #### Drop IE11 support
 
 This allows us to use modern CSS in order to improve the quality of \`react-select\` and remove excessive JavaScript code to work around not having the ability to use modern CSS. If you need IE11 support either: