diff --git a/content/docs/reference/addon-api/addon.tab/_index.md b/content/docs/reference/addon-api/addon.tab/_index.md
index 111ee180e..c775f5d82 100644
--- a/content/docs/reference/addon-api/addon.tab/_index.md
+++ b/content/docs/reference/addon-api/addon.tab/_index.md
@@ -348,6 +348,229 @@ Internally uses `window.django.gettext` or `window._messages`.
See [addon.tab.appendToSharedSpace](addon.tab.appendtosharedspace).
+### `addon.tab.createModal`
+
+
+ Parameter |
+ Type |
+ Required |
+ Description |
+
+
+ title |
+ string |
+ Yes |
+ The title of the modal. |
+
+
+ options |
+ object |
+ No |
+
+
+
+ Parameter |
+ Type |
+ Default |
+ Description |
+
+
+ isOpen |
+ Boolean |
+ false |
+ Whether to open the modal by default. |
+
+
+ useEditorClasses |
+ Boolean |
+ false |
+ If in the editor, whether to apply the editor styles instead of the scratch-www ones. |
+
+
+ useSizesClass |
+ Boolean |
+ false |
+ If on scratch-www , whether to add the modal-sizes class. |
+
+
+ |
+
+
+
+
+
+ Return value |
+ Object |
+
+
+
+Returns a blank modal using Scratch's styles. The modal's properties are listed below.
+
+
+
+ Property |
+ Type |
+ Description |
+
+
+ container |
+ HTMLElement |
+ The container element. |
+
+
+ content |
+ HTMLElement |
+ Where the content should be appended. |
+
+
+ backdrop |
+ HTMLElement |
+ The modal overlay. |
+
+
+ closeButton |
+ HTMLElement |
+ The close (X) button on the header. |
+
+
+ open |
+ Function |
+ Opens the modal. |
+
+
+ close |
+ Function |
+ Closes the modal. |
+
+
+ remove |
+ Function |
+ Removes the modal, making it no longer usable. |
+
+
+
+### `addon.tab.confirm`
+
+
+ Parameter |
+ Type |
+ Required |
+ Description |
+
+
+ title |
+ string |
+ Yes |
+ The title of the modal. |
+
+
+ message |
+ string |
+ Yes |
+ The message displayed in the modal. |
+
+
+ options |
+ object |
+ No |
+
+
+
+ Parameter |
+ Type |
+ Default |
+ Description |
+
+
+ useEditorClasses |
+ Boolean |
+ false |
+ If in the editor, whether to apply the editor styles instead of the scratch-www ones. |
+
+
+ okButtonLabel |
+ string |
+ "OK" |
+ The label of the button for approving the confirmation. |
+
+
+ cancelButtonLabel |
+ string |
+ "Cancel" |
+ The label of the button for rejecting the confirmation. |
+
+
+ |
+
+
+
+
+
+ Return value |
+ Promise<Boolean> |
+
+
+
+Similar to `window.confirm`, except it's asynchronous and uses Scratch's styles.
+
+### `addon.tab.prompt`
+
+
+ Parameter |
+ Type |
+ Required |
+ Description |
+
+
+ title |
+ string |
+ Yes |
+ The title of the modal. |
+
+
+ message |
+ string |
+ Yes |
+ The message displayed in the modal. |
+
+
+ defaultValue |
+ string |
+ No |
+ The initial value of the text box. |
+
+
+ options |
+ object |
+ No |
+
+
+
+ Parameter |
+ Type |
+ Default |
+ Description |
+
+
+ useEditorClasses |
+ Boolean |
+ false |
+ If in the editor, whether to apply the editor styles instead of the scratch-www ones. |
+
+
+ |
+
+
+
+
+
+ Return value |
+ Promise<string | null> |
+
+
+
+Similar to `window.prompt`, except it's asynchronous and uses Scratch's styles.
+
### `addon.tab.createBlockContextMenu`