diff --git a/packages/docs/docs/codelabs/custom-renderer/understand-connection-shapes.mdx b/packages/docs/docs/codelabs/custom-renderer/understand-connection-shapes.mdx
index 13572842109..82aa530394b 100644
--- a/packages/docs/docs/codelabs/custom-renderer/understand-connection-shapes.mdx
+++ b/packages/docs/docs/codelabs/custom-renderer/understand-connection-shapes.mdx
@@ -14,7 +14,7 @@ The outline of the block is a single [SVG path](https://developer.mozilla.org/en
 
 Each sub-path is a string of [path commands](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/d#path_commands) that describe the appropriate shape. These commands must use relative (rather than absolute) coordinates.
 
-SVG path commands can be written as strings, but Blockly provides a set of [utility functions](/reference/blockly.utils.svgpaths) to make writing and reading paths easier.
+SVG path commands can be written as strings, but Blockly provides a set of [utility functions](/reference/blockly.utils_namespace.svgpaths_namespace) to make writing and reading paths easier.
 
 ### `init()`
 
diff --git a/packages/docs/docs/guides/configure/appearance/block-colour.mdx b/packages/docs/docs/guides/configure/appearance/block-colour.mdx
index b827d08b76e..bc071f2a4df 100644
--- a/packages/docs/docs/guides/configure/appearance/block-colour.mdx
+++ b/packages/docs/docs/guides/configure/appearance/block-colour.mdx
@@ -53,7 +53,7 @@ see [Colour formats](/guides/configure/appearance/colour-formats).
 Note the British spelling. Failure to set the colour results in a black block.
 
 You can also set the block color using the
-[`Block.setColour(..)`](/reference/blockly.block.setcolour)
+[`Block.setColour(..)`](/reference/blockly.block_class.setcolour_method)
 function, or by using [themes](/guides/configure/appearance/themes)
 and defining a block style.
 
diff --git a/packages/docs/docs/guides/configure/appearance/colour-formats.mdx b/packages/docs/docs/guides/configure/appearance/colour-formats.mdx
index c04a5b8777a..06b83346a98 100644
--- a/packages/docs/docs/guides/configure/appearance/colour-formats.mdx
+++ b/packages/docs/docs/guides/configure/appearance/colour-formats.mdx
@@ -77,7 +77,7 @@ toolbox categories, plus a distinct colour for dynamic variables:
 ```
 
 These string values can be used in both the JSON definitions and
-[`block.setColour(..)`](/reference/blockly.block.setcolour).
+[`block.setColour(..)`](/reference/blockly.block_class.setcolour_method).
 
 You can add your own colour constants by adding to `Blockly.Msg`:
 
diff --git a/packages/docs/docs/guides/configure/configuration_struct.mdx b/packages/docs/docs/guides/configure/configuration_struct.mdx
index e1706309563..295c101225c 100644
--- a/packages/docs/docs/guides/configure/configuration_struct.mdx
+++ b/packages/docs/docs/guides/configure/configuration_struct.mdx
@@ -36,7 +36,7 @@ directly.
 ## Configuration options \{#the-options-dictionary\}
 
 The configuration object implements
-[`Blockly.BlocklyOptions`](/reference/blockly.blocklyoptions)
+[`Blockly.BlocklyOptions`](/reference/blockly.blocklyoptions_interface)
 and has the following options. Note that several of these options change their
 default value based on whether the provided toolbox has categories or not.
 
@@ -70,8 +70,8 @@ default value based on whether the provided toolbox has categories or not.
 [Grid]: /guides/configure/grid
 [media]: /guides/configure/media
 [Move]: /guides/configure/move
-[setIsReadOnly]: /reference/blockly.workspace.setisreadonly
-[isReadOnly]: /reference/blockly.workspace.isreadonly
+[setIsReadOnly]: /reference/blockly.workspace_class.setisreadonly_method
+[isReadOnly]: /reference/blockly.workspace_class.isreadonly_method
 [renderer]: /guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation
 [RTL demo]: https://raspberrypifoundation.github.io/blockly-samples/examples/rtl-demo/
 [Themes]: /guides/configure/appearance/themes
diff --git a/packages/docs/docs/guides/configure/context-menus.mdx b/packages/docs/docs/guides/configure/context-menus.mdx
index 2b418c81085..acc34e4578d 100644
--- a/packages/docs/docs/guides/configure/context-menus.mdx
+++ b/packages/docs/docs/guides/configure/context-menus.mdx
@@ -480,15 +480,15 @@ steps:
 
 [block-default-menu-image]: /images/context-menus/block-default-menu.png
 [context-menu-items-source]: https://github.com/RaspberryPiFoundation/blockly/blob/main/packages/blockly/core/contextmenu_items.ts
-[i-context-menu]: /reference/blockly.icontextmenu
-[i-focusable-node]: /reference/blockly.ifocusablenode
-[RegistryItem]: /reference/blockly.contextmenuregistry.registryitem
+[i-context-menu]: /reference/blockly.icontextmenu_interface
+[i-focusable-node]: /reference/blockly.ifocusablenode_interface
+[RegistryItem]: /reference/blockly.contextmenuregistry_namespace.registryitem_typealias
 [Scope]: #scope
 [enabled-image]: /images/context-menus/enabled-option.png
 [disabled-image]: /images/context-menus/disabled-option.png
-[customContextMenu]: /reference/blockly.blocksvg.customcontextmenu
-[configureContextMenu]: /reference/blockly.workspacesvg.configurecontextmenu
-[ContextMenuOption]: /reference/blockly.contextmenuregistry.contextmenuoption
-[LegacyContextMenuOption]: /reference/blockly.contextmenuregistry.legacycontextmenuoption
+[customContextMenu]: /reference/blockly.blocksvg_class.customcontextmenu_property
+[configureContextMenu]: /reference/blockly.workspacesvg_class.configurecontextmenu_property
+[ContextMenuOption]: /reference/blockly.contextmenuregistry_namespace.contextmenuoption_typealias
+[LegacyContextMenuOption]: /reference/blockly.contextmenuregistry_namespace.legacycontextmenuoption_interface
 [coordinate-systems]: /guides/configure/metrics_manager#coordinate-systems
 [keyboard-navigation-plugin]: /guides/configure/keyboard-nav
diff --git a/packages/docs/docs/guides/configure/copy-paste.mdx b/packages/docs/docs/guides/configure/copy-paste.mdx
index 22c3bba886f..d9902522848 100644
--- a/packages/docs/docs/guides/configure/copy-paste.mdx
+++ b/packages/docs/docs/guides/configure/copy-paste.mdx
@@ -153,15 +153,15 @@ Blockly.clipboard.registry.register('MY_PASTER', new MyPaster());
 ```
 
 [implement-paster]: /guides/configure/copy-paste#implement-a-paster
-[ICopyable]: /reference/blockly.icopyable
-[IDeletable]: /reference/blockly.ideletable
-[IDraggable]: /reference/blockly.idraggable
-[ICopyData]: /reference/blockly.icopyable.icopydata
-[IPaster]: /reference/blockly.ipaster
-[ISelectable]: /reference/blockly.iselectable
+[ICopyable]: /reference/blockly.icopyable_interface
+[IDeletable]: /reference/blockly.ideletable_interface
+[IDraggable]: /reference/blockly.idraggable_interface
+[ICopyData]: /reference/blockly.icopyable_namespace.icopydata_interface
+[IPaster]: /reference/blockly.ipaster_interface
+[ISelectable]: /reference/blockly.iselectable_interface
 [default-keyboard-shortcuts]: /guides/configure/keyboard-shortcuts#default-shortcuts
 [context-menu-option]: /guides/configure/context-menus
 [custom-draggables]: /guides/configure/dragging/draggable
 [multiselect-plugin]: https://www.npmjs.com/package/@mit-app-inventor/blockly-plugin-workspace-multiselect
 [cross-tab-copy-paste-plugin]: https://www.npmjs.com/package/@blockly/plugin-cross-tab-copy-paste
-[clipboard-namespace]: /reference/blockly.clipboard
+[clipboard-namespace]: /reference/blockly.clipboard_namespace
diff --git a/packages/docs/docs/guides/configure/customization.mdx b/packages/docs/docs/guides/configure/customization.mdx
index 9f82fbde2ef..49193f2a16a 100644
--- a/packages/docs/docs/guides/configure/customization.mdx
+++ b/packages/docs/docs/guides/configure/customization.mdx
@@ -28,23 +28,23 @@ The following Blockly classes can be replaced:
 For information about how to replace a renderer, see [Create custom
 renderers](/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation).
 
-[`Blockly.dragging.Dragger`]: /reference/blockly.dragging.dragger
-[`Blockly.IDragger`]: /reference/blockly.idragger
-[`Blockly.ConnectionChecker`]: /reference/blockly.connectionchecker
-[`Blockly.IConnectionChecker`]: /reference/blockly.iconnectionchecker
-[`Blockly.InsertionMarkerPreviewer`]: /reference/blockly.insertionmarkerpreviewer
-[`Blockly.IConnectionPreviewer`]: /reference/blockly.iconnectionpreviewer
-[`Blockly.HorizontalFlyout`]: /reference/blockly.horizontalflyout
-[`Blockly.VerticalFlyout`]: /reference/blockly.verticalflyout
-[`Blockly.IFlyout`]: /reference/blockly.iflyout
-[`Blockly.MetricsManager`]: /reference/blockly.metricsmanager
-[`Blockly.IMetricsManager`]: /reference/blockly.imetricsmanager
-[`Blockly.Toolbox`]: /reference/blockly.toolbox
-[`Blockly.IToolbox`]: /reference/blockly.itoolbox
-[`Blockly.VariableMap`]: /reference/blockly.variablemap
-[`Blockly.IVariableMap`]: /reference/blockly.ivariablemap
-[`Blockly.VariableModel`]: /reference/blockly.variablemodel
-[`Blockly.IVariableModel`]: /reference/blockly.ivariablemodel
+[`Blockly.dragging.Dragger`]: /reference/blockly.dragging_namespace.dragger_class
+[`Blockly.IDragger`]: /reference/blockly.idragger_interface
+[`Blockly.ConnectionChecker`]: /reference/blockly.connectionchecker_class
+[`Blockly.IConnectionChecker`]: /reference/blockly.iconnectionchecker_interface
+[`Blockly.InsertionMarkerPreviewer`]: /reference/blockly.insertionmarkerpreviewer_class
+[`Blockly.IConnectionPreviewer`]: /reference/blockly.iconnectionpreviewer_interface
+[`Blockly.HorizontalFlyout`]: /reference/blockly.horizontalflyout_class
+[`Blockly.VerticalFlyout`]: /reference/blockly.verticalflyout_class
+[`Blockly.IFlyout`]: /reference/blockly.iflyout_interface
+[`Blockly.MetricsManager`]: /reference/blockly.metricsmanager_class
+[`Blockly.IMetricsManager`]: /reference/blockly.imetricsmanager_interface
+[`Blockly.Toolbox`]: /reference/blockly.toolbox_class
+[`Blockly.IToolbox`]: /reference/blockly.itoolbox_interface
+[`Blockly.VariableMap`]: /reference/blockly.variablemap_class
+[`Blockly.IVariableMap`]: /reference/blockly.ivariablemap_interface
+[`Blockly.VariableModel`]: /reference/blockly.variablemodel_class
+[`Blockly.IVariableModel`]: /reference/blockly.ivariablemodel_interface
 
 ## Create a replacement class
 
diff --git a/packages/docs/docs/guides/configure/dragging/block-drag-strategies.mdx b/packages/docs/docs/guides/configure/dragging/block-drag-strategies.mdx
index 3d07344ddd4..8bdd6f25a38 100644
--- a/packages/docs/docs/guides/configure/dragging/block-drag-strategies.mdx
+++ b/packages/docs/docs/guides/configure/dragging/block-drag-strategies.mdx
@@ -47,6 +47,6 @@ Blockly.Blocks['my_block'] = {
 
 [draggable]: /guides/configure/dragging/draggable
 [draggable-implementation]: /guides/configure/dragging/draggable#implementation
-[setDragStrategy]: /reference/blockly.blocksvg.setdragstrategy
-[IDraggable]: /reference/blockly.idraggable
-[IDragStrategy]: /reference/blockly.idragstrategy
+[setDragStrategy]: /reference/blockly.blocksvg_class.setdragstrategy_method
+[IDraggable]: /reference/blockly.idraggable_interface
+[IDragStrategy]: /reference/blockly.idragstrategy_interface
diff --git a/packages/docs/docs/guides/configure/dragging/draggable.mdx b/packages/docs/docs/guides/configure/dragging/draggable.mdx
index 8068609611f..68489b931d9 100644
--- a/packages/docs/docs/guides/configure/dragging/draggable.mdx
+++ b/packages/docs/docs/guides/configure/dragging/draggable.mdx
@@ -232,12 +232,12 @@ For more information about copying pasting see [Copy paste][copy-paste].
 
 {/* This doesn't exist yet */}
 [events]: /guides/configure/events
-[IRenderedElement]: /reference/blockly.irenderedelement
-[IDraggable]: /reference/blockly.idraggable
-[IDeletable]: /reference/blockly.ideletable
-[ISelectable]: /reference/blockly.iselectable
-[setSelected]: /reference/blockly.common
+[IRenderedElement]: /reference/blockly.irenderedelement_interface
+[IDraggable]: /reference/blockly.idraggable_interface
+[IDeletable]: /reference/blockly.ideletable_interface
+[ISelectable]: /reference/blockly.iselectable_interface
+[setSelected]: /reference/blockly.common_namespace
 [svg-group]: https://developer.mozilla.org/en-US/docs/Web/SVG/Element/g
-[Coordinate]: /reference/blockly.utils.coordinate
-[drag-target]: /reference/blockly.dragtarget
+[Coordinate]: /reference/blockly.utils_namespace.coordinate_class
+[drag-target]: /reference/blockly.dragtarget_class
 [copy-paste]: /guides/configure/copy-paste
diff --git a/packages/docs/docs/guides/configure/dragging/dragger.mdx b/packages/docs/docs/guides/configure/dragging/dragger.mdx
index 201b2010a92..3bdcb4f5bb6 100644
--- a/packages/docs/docs/guides/configure/dragging/dragger.mdx
+++ b/packages/docs/docs/guides/configure/dragging/dragger.mdx
@@ -169,6 +169,6 @@ const myWorkspace = Blockly.inject('blocklyDiv', {
 ```
 
 [draggable]: /guides/configure/dragging/draggable
-[drag-target]: /reference/blockly.dragtarget
+[drag-target]: /reference/blockly.dragtarget_class
 [scroll-options-plugin]: https://www.npmjs.com/package/@blockly/plugin-scroll-options
-[IDragger]: /reference/blockly.idragger
+[IDragger]: /reference/blockly.idragger_interface
diff --git a/packages/docs/docs/guides/configure/focus.mdx b/packages/docs/docs/guides/configure/focus.mdx
index 9558d28fbc4..464c334d405 100644
--- a/packages/docs/docs/guides/configure/focus.mdx
+++ b/packages/docs/docs/guides/configure/focus.mdx
@@ -271,8 +271,8 @@ in an exception.
 
 If you write a custom component from scratch, you'll need to implement the focus
 interfaces yourself. See the reference documentation for
-[`IFocusableTree`](/reference/blockly.ifocusabletree) and
-[`IFocusableNode`](/reference/blockly.ifocusablenode) more
+[`IFocusableTree`](/reference/blockly.ifocusabletree_interface) and
+[`IFocusableNode`](/reference/blockly.ifocusablenode_interface) more
 information.
 
 After you have implemented your class, test it against the keyboard navigation
@@ -367,7 +367,7 @@ manager just changes the actively focused node to passive focus.)
 
 Positionables are components that are positioned on top of the workspace and
 implement
-[`IPositionable`](/reference/blockly.ipositionable).
+[`IPositionable`](/reference/blockly.ipositionable_interface).
 Examples are the trashcan and the backpack in the [backpack
 plugin](https://www.npmjs.com/package/@blockly/workspace-backpack).
 Built-in positionables are integrated with the focus system, but if you create
diff --git a/packages/docs/docs/guides/configure/keyboard-shortcuts.mdx b/packages/docs/docs/guides/configure/keyboard-shortcuts.mdx
index bd5ec83d29f..53e4bdb231d 100644
--- a/packages/docs/docs/guides/configure/keyboard-shortcuts.mdx
+++ b/packages/docs/docs/guides/configure/keyboard-shortcuts.mdx
@@ -33,14 +33,14 @@ user presses a key (or combination of keys), Blockly:
 ## Scope
 
 A
-[`Scope`](/reference/blockly.contextmenuregistry.scope)
+[`Scope`](/reference/blockly.contextmenuregistry_namespace.scope_interface)
 object identifies the Blockly component that currently has focus. Scope objects
 are passed to `preconditionFn` and `callback`, which use them to decide whether
 a shortcut applies to a particular component and, if so, how to apply it.
 
 To use a `Scope` object, use its `focusedNode` property. This is an object that
 implements
-[`IFocusableNode`](/reference/blockly.ifocusablenode). This
+[`IFocusableNode`](/reference/blockly.ifocusablenode_interface). This
 interface is implemented by all Blockly components that the user can focus on,
 including workspaces, blocks, fields, comments, and your own custom components;
 for more information, see the documentation on the
@@ -58,7 +58,7 @@ preconditionFn(workspace, scope) {
 ## The KeyboardShortcut interface
 
 Objects in the shortcut registry implement the
-[`KeyboardShortcut`](/reference/blockly.shortcutregistry.keyboardshortcut)
+[`KeyboardShortcut`](/reference/blockly.shortcutregistry_namespace.keyboardshortcut_interface)
 interface. This contains the following properties.
 
 ### name (required)
@@ -138,7 +138,7 @@ not do anything.
 
 An array of keys (or combinations of keys) that activate this shortcut. To
 identify keys, use the keycodes in
-[`Blockly.utils.KeyCodes`](/reference/blockly.utils.keycodes).
+[`Blockly.utils.KeyCodes`](/reference/blockly.utils_namespace.keycodes_enum).
 For example:
 
 ```js
@@ -151,7 +151,7 @@ const logFieldsShortcut = {
 
 If you want map additional keys to an existing shortcut -- for example, you want
 to add keys to a [default shortcut](#default-shortcuts) -- you can call
-[`Blockly.ShortcutRegistry.registry.addKeyMapping`](/reference/blockly.shortcutregistry.addkeymapping).
+[`Blockly.ShortcutRegistry.registry.addKeyMapping`](/reference/blockly.shortcutregistry_class.addkeymapping_method).
 This is not common.
 
 #### Key combinations
diff --git a/packages/docs/docs/guides/configure/metrics_manager.mdx b/packages/docs/docs/guides/configure/metrics_manager.mdx
index aca7d968cd7..a65115222ea 100644
--- a/packages/docs/docs/guides/configure/metrics_manager.mdx
+++ b/packages/docs/docs/guides/configure/metrics_manager.mdx
@@ -114,7 +114,7 @@ the bounding box around any blocks or workspace comments.
 
 :::note
 Content metrics do not take into account block comments, only [workspace
-comments](/reference/blockly.comments.workspacecomment).
+comments](/reference/blockly.comments_namespace.workspacecomment_class).
 :::
 
 <Image
diff --git a/packages/docs/docs/guides/configure/serialization.mdx b/packages/docs/docs/guides/configure/serialization.mdx
index 1b2ce14196a..db292837ca6 100644
--- a/packages/docs/docs/guides/configure/serialization.mdx
+++ b/packages/docs/docs/guides/configure/serialization.mdx
@@ -173,7 +173,7 @@ When you register a serializer you must provide several things:
   order](/guides/configure/serialization#deserialization-order).
 
   You can base the priority of your serializer on the [built-in
-  priorities](/reference/blockly.serialization.priorities)
+  priorities](/reference/blockly.serialization_namespace.priorities_namespace)
 
 When `Blockly.serialization.workspaces.save` is called, each serializer's `save`
 function will be called, and its data will be added to the final JSON output:
@@ -218,7 +218,7 @@ For information on how to migrate to JSON, see the [migration guide].
 ### APIs
 
 For information about the XML system's APIs see the [reference
-documentation](/reference/blockly.xml).
+documentation](/reference/blockly.xml_namespace).
 
 ### Block hooks
 
diff --git a/packages/docs/docs/guides/configure/toolboxes/preset.mdx b/packages/docs/docs/guides/configure/toolboxes/preset.mdx
index 4a8ccac52be..00230e4de14 100644
--- a/packages/docs/docs/guides/configure/toolboxes/preset.mdx
+++ b/packages/docs/docs/guides/configure/toolboxes/preset.mdx
@@ -171,7 +171,7 @@ out.](/images/toolbox-disabled.png)
   </TabItem>
 </Tabs>
 You can also programmatically disable or enable a block by using
-[`setDisabledReason`](/reference/blockly.block.setdisabledreason).
+[`setDisabledReason`](/reference/blockly.block_class.setdisabledreason_method).
 
 ## Configure your blocks
 
diff --git a/packages/docs/docs/guides/create-custom-blocks/define/block-definitions.mdx b/packages/docs/docs/guides/create-custom-blocks/define/block-definitions.mdx
index 4212eb00121..71601748e10 100644
--- a/packages/docs/docs/guides/create-custom-blocks/define/block-definitions.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/define/block-definitions.mdx
@@ -70,15 +70,15 @@ Because the definition functions are mixed in to the block object:
 
 - The `this` keyword in definition functions refers to the block object. That
   is, it can be used to access the public methods and properties in the
-  [`Block`](/reference/blockly.block) (or
-  [`BlockSvg`](/reference/blockly.blocksvg)) class.
+  [`Block`](/reference/blockly.block_class) (or
+  [`BlockSvg`](/reference/blockly.blocksvg_class)) class.
 
 Blockly defines a small number of functions you can use to customize blocks. The
 most common of these is `init`, which Blockly calls to initialize a block and
 which is used to define the block's look and feel. For a complete list, see the
 function-valued properties in the
-[`Block`](/reference/blockly.block) and
-[`BlockSvg`](/reference/blockly.blocksvg#properties) classes.
+[`Block`](/reference/blockly.block_class#properties) and
+[`BlockSvg`](/reference/blockly.blocksvg_class#properties) classes.
 These properties effectively form an interface for block definitions to
 implement; all of them are optional.
 
diff --git a/packages/docs/docs/guides/create-custom-blocks/define/json-and-js.mdx b/packages/docs/docs/guides/create-custom-blocks/define/json-and-js.mdx
index 318ce0713fc..1c37da0d70d 100644
--- a/packages/docs/docs/guides/create-custom-blocks/define/json-and-js.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/define/json-and-js.mdx
@@ -156,7 +156,7 @@ This section summarizes the objects and functions used to define custom blocks.
 
 ### Blockly.Blocks
 
-[`Blockly.Blocks`](/reference/blockly.blocks) is an object
+[`Blockly.Blocks`](/reference/blockly.blocks_variable) is an object
 that stores block definitions. Its keys are block type names and its values are
 block definition objects. Use `Blockly.Blocks` when defining blocks with
 JavaScript:
@@ -184,7 +184,7 @@ Blockly.Blocks['my_block'].setColour(150);
 
 ### defineBlocksWithJsonArray
 
-[`defineBlocksWithJsonArray`](/reference/blockly.common.defineblockswithjsonarray)
+[`defineBlocksWithJsonArray`](/reference/blockly.common_namespace.defineblockswithjsonarray_function)
 accepts an array of JSON objects, creates block definitions from them, and adds
 them to `Blockly.Blocks`.
 
@@ -207,7 +207,7 @@ Blockly.common.defineBlocksWithJsonArray([
 
 ### createBlockDefinitionsFromJsonArray and defineBlocks
 
-[`createBlockDefinitionsFromJsonArray`](/reference/blockly.common.createblockdefinitionsfromjsonarray)
+[`createBlockDefinitionsFromJsonArray`](/reference/blockly.common_namespace.createblockdefinitionsfromjsonarray_function)
 accepts an array of JSON objects and returns an object that maps block type
 names to block definitions. This is generally used with `defineBlocks`, which
 adds the block definitions to `Blockly.Blocks`.
@@ -233,7 +233,7 @@ Blockly.common.defineBlocks(myBlockDefinitions);
 
 ### Block.jsonInit
 
-[`jsonInit`](/reference/blockly.block.jsoninit)
+[`jsonInit`](/reference/blockly.block_class.jsoninit_method)
 accepts a JSON object and calls the corresponding methods on `Block`. For
 example, a JSON object with the key-value pair `colour: 150` results in a call
 to `this.setColour(150)`. Use `jsonInit` in an `init` function to load a JSON
diff --git a/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/image.mdx b/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/image.mdx
index 579ba0203ce..e4ec5b08c51 100644
--- a/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/image.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/image.mdx
@@ -98,7 +98,7 @@ can act like buttons that exist on blocks.
 
 The on click handler can be set in the [JavaScript Constructor](#creation) or
 using the
-[`setOnClickHandler`](/reference/blockly.fieldimage.setonclickhandler)
+[`setOnClickHandler`](/reference/blockly.fieldimage_class.setonclickhandler_method)
 function.
 
 Here is an example of an on click handler that collapses the block when
diff --git a/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/label.mdx b/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/label.mdx
index e01c56a05e9..d8bbf12439e 100644
--- a/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/label.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/label.mdx
@@ -74,7 +74,7 @@ collapsed.](/images/fields/label/collapsed.png)
   ```
   </TabItem>
 </Tabs>
-The [`appendField`](/reference/blockly.input.appendfield)
+The [`appendField`](/reference/blockly.input_class.appendfield_method)
 function accepts both `FieldLabel` objects and, more commonly, strings to create
 labels.
 
diff --git a/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/number.mdx b/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/number.mdx
index c6d443afb5e..95d7cc30238 100644
--- a/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/number.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/number.mdx
@@ -124,7 +124,7 @@ feedback about what they're doing wrong.”
 ## Constraints
 
 Constraints can be set in the field definition, or by using the
-[setConstraints](/reference/blockly.fieldnumber.setconstraints)
+[setConstraints](/reference/blockly.fieldnumber_class.setconstraints_method)
 function.
 
 ### Minimum value
diff --git a/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/variable.mdx b/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/variable.mdx
index 05235289068..192f38514c9 100644
--- a/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/variable.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/fields/built-in-fields/variable.mdx
@@ -188,7 +188,7 @@ return a string, `null`, or `undefined`.
 
 Here's an example of a validator that only accepts some predefined variables as
 options. These variables would need to be defined with the
-[`Workspace.getVariableMap().createVariable`](/reference/blockly.ivariablemap.createvariable)
+[`Workspace.getVariableMap().createVariable`](/reference/blockly.ivariablemap_interface.createvariable_methodsignature)
 function when the workspace is loaded.
 
 ```js
diff --git a/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/creating.mdx b/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/creating.mdx
index 9aef78371cc..8afb99bafff 100644
--- a/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/creating.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/creating.mdx
@@ -107,7 +107,7 @@ You also need to define your `fromJson` function. Your implementation should
 first dereference any [references to localization
 tokens](/guides/configure/translations#use-localization-tokens-in-json)
 using
-[`replaceMessageReferences`](/reference/blockly.utils.parsing.replacemessagereferences),
+[`replaceMessageReferences`](/reference/blockly.utils_namespace.parsing_namespace.replacemessagereferences_function),
 and then pass the values to the constructor.
 
 ```js
@@ -246,11 +246,11 @@ When overriding `bindEvents_` you should always call the base function.
 :::
 
 To bind to an event you should generally use the
-[`Blockly.utils.browserEvents.conditionalBind`](/reference/blockly.utils.browserevents.conditionalbind)
+[`Blockly.utils.browserEvents.conditionalBind`](/reference/blockly.utils_namespace.browserevents_namespace.conditionalbind_function)
 function. This method of binding events filters out secondary touches during
 drags. If you want your handler to run even in the middle of an in-progress drag
 you can use the
-[`Blockly.browserEvents.bind`](/reference/blockly.utils.browserevents.bind)
+[`Blockly.browserEvents.bind`](/reference/blockly.utils_namespace.browserevents_namespace.bind_function)
 function.
 
 ## Disposing
@@ -419,7 +419,7 @@ currently there is no way to enforce this pattern.
 ### isDirty\_
 
 `isDirty_` is a flag used in the
-[`setValue`](/reference/blockly.field.setvalue)
+[`setValue`](/reference/blockly.field_class.setvalue_method)
 function, as well as other parts of the field, to tell if the field needs to be
 re-rendered. If the field's display value has changed, `isDirty_` should usually
 be set to `true`.
@@ -432,7 +432,7 @@ field](/guides/create-custom-blocks/fields/anatomy-of-a-field).
 
 If the text of your field is different than the value of your field, you should
 override the
-[`getText`](/reference/blockly.field.gettext_)function
+[`getText`](/reference/blockly.field_class.gettext_method)function
 to provide the correct text.
 
 ```js
@@ -492,7 +492,7 @@ the `DropDownDiv`.
 
 ![Image of angle picker](/images/angle-picker.png)
 
-The [`WidgetDiv`](/reference/blockly.widgetdiv) is used to
+The [`WidgetDiv`](/reference/blockly.widgetdiv_namespace) is used to
 provide editors that do not live inside of a box. Number fields use the
 `WidgetDiv` to cover the field with an HTML text input box. While the
 `DropDownDiv` handles positioning for you, the `WidgetDiv` does not. Elements
@@ -605,7 +605,7 @@ property to `true`.
 ### Defaults
 
 The default `render_` function sets the display text to the result of the
-[`getDisplayText_`](/reference/blockly.field.getdisplaytext_)
+[`getDisplayText_`](/reference/blockly.field_class.getdisplaytext__method)
 function. The `getDisplayText_` function returns the field's `value_` property
 cast to a string, after it has been truncated to respect the maximum text
 length.
diff --git a/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/upgrading.mdx b/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/upgrading.mdx
index 40fd4ef801c..5c9f9014037 100644
--- a/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/upgrading.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/fields/customizing-fields/upgrading.mdx
@@ -310,9 +310,9 @@ handling](/guides/create-custom-blocks/fields/customizing-fields/creating#value-
 
 We recommend that you never access or update the `text_` property of your
 field directly. Instead, use the
-[`getText`](/reference/blockly.field.gettext_) function
+[`getText`](/reference/blockly.field_class.gettext_method) function
 to access the user readable text of your field and the
-[`setValue`](/reference/blockly.field.setvalue) function
+[`setValue`](/reference/blockly.field_class.setvalue_method) function
 to update the stored value of your field.
 
 For more information about a field's value vs its text see
diff --git a/packages/docs/docs/guides/create-custom-blocks/fields/validators.mdx b/packages/docs/docs/guides/create-custom-blocks/fields/validators.mdx
index ea1a269b9dc..cb7101db4a2 100644
--- a/packages/docs/docs/guides/create-custom-blocks/fields/validators.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/fields/validators.mdx
@@ -80,7 +80,7 @@ Blockly.Blocks['validator_example'] = {
 ```
 
 - With
-  [`setValidator`](/reference/blockly.field.setvalidator).
+  [`setValidator`](/reference/blockly.field_class.setvalidator_method).
 
 ```js
 Blockly.Blocks['validator_example'] = {
diff --git a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/basic-implementation.mdx b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/basic-implementation.mdx
index c33b3f2662a..ac39ff62dad 100644
--- a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/basic-implementation.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/basic-implementation.mdx
@@ -192,18 +192,18 @@ dispose() {
 ```
 
 [bubble]: /guides/create-custom-blocks/icons/creating-custom-icons/use-bubbles
-[IIcon]: /reference/blockly.iicon
-[Icon]: /reference/blockly.icons.icon
-[getType]: /reference/blockly.iicon.gettype
+[IIcon]: /reference/blockly.iicon_interface
+[Icon]: /reference/blockly.icons_namespace.icon_class
+[getType]: /reference/blockly.iicon_interface.gettype_methodsignature
 [registering]: /guides/create-custom-blocks/icons/creating-custom-icons/save-and-load#register-icon-classes
-[getIcon]: /reference/blockly.block.geticon
-[initView]: /reference/blockly.iicon.initview
-[blockly-utils-dom]: /reference/blockly.utils.dom
-[getSize]: /reference/blockly.iicon.getsize
+[getIcon]: /reference/blockly.block_class.geticon_method
+[initView]: /reference/blockly.iicon_interface.initview_methodsignature
+[blockly-utils-dom]: /reference/blockly.utils_namespace.dom_namespace
+[getSize]: /reference/blockly.iicon_interface.getsize_methodsignature
 [renderer]: /guides/create-custom-blocks/renderers/overview
-[getWeight]: /reference/blockly.iicon.getweight
-[onClick]: /reference/blockly.iicon.onclick
-[updateEditable]: /reference/blockly.iicon.updateeditable
-[isShownWhenCollapsed]: /reference/blockly.iicon.isshownwhencollapsed
-[updateCollapsed]: /reference/blockly.iicon.updatecollapsed
-[dispose]: /reference/blockly.iicon.dispose
+[getWeight]: /reference/blockly.iicon_interface.getweight_methodsignature
+[onClick]: /reference/blockly.iicon_interface.onclick_methodsignature
+[updateEditable]: /reference/blockly.iicon_interface.updateeditable_methodsignature
+[isShownWhenCollapsed]: /reference/blockly.iicon_interface.isshownwhencollapsed_methodsignature
+[updateCollapsed]: /reference/blockly.iicon_interface.updatecollapsed_methodsignature
+[dispose]: /reference/blockly.iicon_interface.dispose_methodsignature
diff --git a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/creating-custom-bubbles.mdx b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/creating-custom-bubbles.mdx
index 1f0f0b3a0ed..f2d21f253b1 100644
--- a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/creating-custom-bubbles.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/creating-custom-bubbles.mdx
@@ -80,8 +80,8 @@ dispose() {
 }
 ```
 
-[built-in-bubbles]: /reference/blockly.bubbles
-[blockly-utils-dom]: /reference/blockly.utils.dom
-[bubble]: /reference/blockly.bubbles.bubble
-[setSize]: /reference/blockly.bubbles.bubble.setsize
-[dispose]: /reference/blockly.bubbles.bubble.dispose
+[built-in-bubbles]: /reference/blockly.bubbles_namespace
+[blockly-utils-dom]: /reference/blockly.utils_namespace.dom_namespace
+[bubble]: /reference/blockly.bubbles_namespace.bubble_class
+[setSize]: /reference/blockly.bubbles_namespace.bubble_class.setsize_method
+[dispose]: /reference/blockly.bubbles_namespace.bubble_class.dispose_method
diff --git a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/override-built-in.mdx b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/override-built-in.mdx
index 131fab77c21..acb81b58961 100644
--- a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/override-built-in.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/override-built-in.mdx
@@ -41,7 +41,7 @@ class MyCommentIcon extends Blockly.icons.CommentIcon {
 
 To customize your icon, you can override methods in `ICommentIcon` (described in
 the following sections) and
-[`Blockly.icons.Icon`](/reference/blockly.icons.icon)
+[`Blockly.icons.Icon`](/reference/blockly.icons_namespace.icon_class)
 (described in [Create custom
 icons](/guides/create-custom-blocks/icons/creating-custom-icons/basic-implementation)).
 Do not override `getType`, which must return `Blockly.icons.IconType.COMMENT`.
@@ -157,9 +157,9 @@ comment icon, such as when the user clicks "Add Comment" on the context menu or
 you call `myBlock.setCommentText()`.
 
 [ICommentIcon]: /reference/blockly.icommenticon_interface
-[IHasBubble]: /reference/blockly.ihasbubble
+[IHasBubble]: /reference/blockly.ihasbubble_interface
 [use-bubbles]: /guides/create-custom-blocks/icons/creating-custom-icons/use-bubbles
-[ISerializable]: /reference/blockly.iserializable
-[CommentState]: /reference/blockly.icons.commentstate
+[ISerializable]: /reference/blockly.iserializable_interface
+[CommentState]: /reference/blockly.icons_namespace.commentstate_interface
 [icon-serialization]: /guides/create-custom-blocks/icons/creating-custom-icons/save-and-load
 [comment-icon-image]: /images/block-icons/comment-icon-outline.png
diff --git a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/save-and-load.mdx b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/save-and-load.mdx
index 712d59ee094..8916831381f 100644
--- a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/save-and-load.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/save-and-load.mdx
@@ -99,10 +99,10 @@ class myIcon extends Blockly.icons.Icon {
 Blockly.icons.registry.register(new Blockly.icons.IconType('my_icon'), myIcon);
 ```
 
-[ISerializable]: /reference/blockly.iserializable
+[ISerializable]: /reference/blockly.iserializable_interface
 [registering]: /guides/create-custom-blocks/icons/creating-custom-icons/save-and-load#register-icon-classes
-[saveState]: /reference/blockly.iserializable.savestate
-[loadState]: /reference/blockly.iserializable.loadstate
-[IconType]: /reference/blockly.icons.icontype
-[getType]: /reference/blockly.iicon.gettype
+[saveState]: /reference/blockly.iserializable_interface.savestate_methodsignature
+[loadState]: /reference/blockly.iserializable_interface.loadstate_methodsignature
+[IconType]: /reference/blockly.icons_namespace.icontype_class
+[getType]: /reference/blockly.iicon_interface.gettype_methodsignature
 [serializer]: /guides/configure/serialization#serializer-hooks
diff --git a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/use-bubbles.mdx b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/use-bubbles.mdx
index 25089dc487e..06815d84f98 100644
--- a/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/use-bubbles.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/icons/creating-custom-icons/use-bubbles.mdx
@@ -79,8 +79,8 @@ isBubbleVisible() {
 }
 ```
 
-[IIcon]: /reference/blockly.iicon
-[IHasBubble]: /reference/blockly.ihasbubble
-[setBubbleVisible]: /reference/blockly.ihasbubble.setbubblevisible
-[bubbleIsVisible]: /reference/blockly.ihasbubble.bubbleisvisible
-[onLocationChange]: /reference/blockly.iicon.onlocationchange
+[IIcon]: /reference/blockly.iicon_interface
+[IHasBubble]: /reference/blockly.ihasbubble_interface
+[setBubbleVisible]: /reference/blockly.ihasbubble_interface.setbubblevisible_methodsignature
+[bubbleIsVisible]: /reference/blockly.ihasbubble_interface.bubbleisvisible_methodsignature
+[onLocationChange]: /reference/blockly.iicon_interface.onlocationchange_methodsignature
diff --git a/packages/docs/docs/guides/create-custom-blocks/icons/overview.mdx b/packages/docs/docs/guides/create-custom-blocks/icons/overview.mdx
index 4658b0ecb57..bd8e5e460ca 100644
--- a/packages/docs/docs/guides/create-custom-blocks/icons/overview.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/icons/overview.mdx
@@ -24,4 +24,4 @@ or copyright information in a pop-up bubble.
 
 [fields-vs-icons]: /guides/create-custom-blocks/fields/fields-vs-icons
 [custom-icons]: /guides/create-custom-blocks/icons/creating-custom-icons/basic-implementation
-[icons-reference]: /reference/blockly.icons
+[icons-reference]: /reference/blockly.icons_namespace
diff --git a/packages/docs/docs/guides/create-custom-blocks/inputs/connection-checks.mdx b/packages/docs/docs/guides/create-custom-blocks/inputs/connection-checks.mdx
index 4411c79e9ac..c0e22876ff4 100644
--- a/packages/docs/docs/guides/create-custom-blocks/inputs/connection-checks.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/inputs/connection-checks.mdx
@@ -238,5 +238,5 @@ connection checker.
 
 [connection-type]: /guides/create-custom-blocks/define/block-anatomy#connections
 [event-system]: /guides/configure/events
-[BlockMove]: /reference/blockly.events.blockmove
+[BlockMove]: /reference/blockly.events_namespace.blockmove_class
 [custom-connection-checker]: /guides/create-custom-blocks/inputs/connection_checker
diff --git a/packages/docs/docs/guides/create-custom-blocks/inputs/connection-previews.mdx b/packages/docs/docs/guides/create-custom-blocks/inputs/connection-previews.mdx
index d3cbce824f6..95388d5c933 100644
--- a/packages/docs/docs/guides/create-custom-blocks/inputs/connection-previews.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/inputs/connection-previews.mdx
@@ -208,7 +208,7 @@ For more information about registration, see
 [built-in-replacement-preview-image]: /images/connections/built-in-replacement-preview.png
 [built-in-insertion-preview-image]: /images/connections/built-in-insertion-preview.png
 [built-in-previewer-image]: /images/connections/built-in-previewer.gif
-[IConnectionPreviewer]: /reference/blockly.iconnectionpreviewer
+[IConnectionPreviewer]: /reference/blockly.iconnectionpreviewer_interface
 [insertion-marker]: /guides/get-started/workspace-anatomy#insertion-marker
 [custom-renderer]: /guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation
 [inject-subclasses]: /guides/configure/customization#injecting-subclasses
diff --git a/packages/docs/docs/guides/create-custom-blocks/inputs/creating-custom-inputs.mdx b/packages/docs/docs/guides/create-custom-blocks/inputs/creating-custom-inputs.mdx
index fc9c8c61fdf..5a8e21a3a7d 100644
--- a/packages/docs/docs/guides/create-custom-blocks/inputs/creating-custom-inputs.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/inputs/creating-custom-inputs.mdx
@@ -49,7 +49,7 @@ unlike [custom fields][custom-fields], you can't override
 built-in inputs, and you can't add custom JSON configuration to them.
 :::
 
-[Input]: /reference/blockly.inputs.input
-[makeConnection]: /reference/blockly.inputs.input.makeconnection
+[Input]: /reference/blockly.inputs_namespace.input_class
+[makeConnection]: /reference/blockly.inputs_namespace.input_class.makeconnection_method
 [json-block-def]: /guides/create-custom-blocks/define/json-and-js
 [custom-fields]: /guides/create-custom-blocks/fields/customizing-fields/creating
diff --git a/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-blocks.mdx b/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-blocks.mdx
index c3eb8d03734..ca70ef100a6 100644
--- a/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-blocks.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-blocks.mdx
@@ -227,7 +227,7 @@ Blockly.Blocks['my_procedure_call'] = {
 
 You can also add the ability for users to modify the procedure model. Calling
 the `insertParameter`, `deleteParameter`, or `setReturnTypes`
-[methods](/reference/blockly.procedures.iproceduremodel)
+[methods](/reference/blockly.procedures_namespace.iproceduremodel_interface)
 will automatically trigger your blocks to rerender (via `doProcedureUpdate`).
 
 Options for creating UIs to modify the procedure model include using
diff --git a/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-data-models.mdx b/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-data-models.mdx
index 6f29378ae4e..2d209925de9 100644
--- a/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-data-models.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/procedures/creating-custom-procedure-data-models.mdx
@@ -126,5 +126,5 @@ class MyParameterModel {
 ```
 
 [shareable-procedures]: https://www.npmjs.com/package/@blockly/block-shareable-procedures
-[IProcedureModel]: /reference/blockly.procedures.iproceduremodel
-[IParameterModel]: /reference/blockly.procedures.iparametermodel
+[IProcedureModel]: /reference/blockly.procedures_namespace.iproceduremodel_interface
+[IParameterModel]: /reference/blockly.procedures_namespace.iparametermodel_interface
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/constants.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/constants.mdx
index 57839339f46..6a2bc75290c 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/constants.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/constants.mdx
@@ -37,8 +37,8 @@ block, like jagged edges for collapsed blocks.
 And finally, the constant provider also defines various values for things like
 the padding between different elements, or the minimum heights of rows.
 
-[ConstantProvider]: /reference/blockly.blockrendering.constantprovider
-[Notch]: /reference/blockly.blockrendering.constantprovider.notch
-[PuzzleTab]: /reference/blockly.blockrendering.constantprovider.puzzle_tab
+[ConstantProvider]: /reference/blockly.blockrendering_namespace.constantprovider_class
+[Notch]: /reference/blockly.blockrendering_namespace.constantprovider_class.notch_property
+[PuzzleTab]: /reference/blockly.blockrendering_namespace.constantprovider_class.puzzle_tab_property
 [connection-check]: /guides/create-custom-blocks/inputs/connection-checks
-[shapeFor]: /reference/blockly.blockrendering.constantprovider.shapefor
+[shapeFor]: /reference/blockly.blockrendering_namespace.constantprovider_class.shapefor_method
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/drawer.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/drawer.mdx
index 5e96276bc41..51b325378dc 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/drawer.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/drawer.mdx
@@ -16,9 +16,9 @@ Blockly to do this.
 
 The drawer also updates the offsets of connections within the block.
 
-[Drawer]: /reference/blockly.blockrendering.drawer
+[Drawer]: /reference/blockly.blockrendering_namespace.drawer_class
 [paths]: https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths
 [render-info]: /guides/create-custom-blocks/renderers/concepts/info
 [path-object]: /guides/create-custom-blocks/renderers/concepts/path-object
 [constants]: /guides/create-custom-blocks/renderers/concepts/constants
-[svg-path-utils]: /reference/blockly.utils.svgpaths
+[svg-path-utils]: /reference/blockly.utils_namespace.svgpaths_namespace
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/elements.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/elements.mdx
index 49209383229..1360a2e478d 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/elements.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/elements.mdx
@@ -53,7 +53,7 @@ depending on the elements to either side of the spacer.
 
 [render-info]: /guides/create-custom-blocks/renderers/concepts/info
 [row]: /guides/create-custom-blocks/renderers/concepts/rows
-[field-element]: /reference/blockly.blockrendering.field
-[getSize]: /reference/blockly.field.getsize
+[field-element]: /reference/blockly.blockrendering_namespace.field_class
+[getSize]: /reference/blockly.field_class.getsize_method
 [element-image]: /images/rendering/debug-renderer/element.png
 [element-spacer-image]: /images/rendering/debug-renderer/element-spacer.png
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/info.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/info.mdx
index 863e7df3a47..ab27e25ab7a 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/info.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/info.mdx
@@ -27,7 +27,7 @@ which are organized into non-overlapping [rows][row], and
 Then the [drawer][drawer] uses that organized layout information to create the
 SVG paths representing the block.
 
-[RenderInfo]: /reference/blockly.blockrendering.renderinfo
+[RenderInfo]: /reference/blockly.blockrendering_namespace.renderinfo_class
 [drawer]: /guides/create-custom-blocks/renderers/concepts/drawer
 [row]: /guides/create-custom-blocks/renderers/concepts/rows
 [element]: /guides/create-custom-blocks/renderers/concepts/elements
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/path-object.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/path-object.mdx
index 8e4e7f1379e..a0b9523910e 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/path-object.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/path-object.mdx
@@ -26,7 +26,7 @@ It also handles:
 - Applying [theme colors][theme] to the SVG elements.
 - Applying other styling to the SVG elements.
 
-[PathObject]: /reference/blockly.blockrendering.pathobject
+[PathObject]: /reference/blockly.blockrendering_namespace.pathobject_class
 [theme]: /guides/configure/appearance/themes#block-style
 [built-in-renderers]: /guides/create-custom-blocks/renderers/overview#built-in-renderers
 [drawer]: /guides/create-custom-blocks/renderers/concepts/drawer
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/renderer.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/renderer.mdx
index 188b832677b..0581365aece 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/renderer.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/renderer.mdx
@@ -16,7 +16,7 @@ And it contains code for wiring them all together when it renders a block.
 If you want to change just one part of an existing renderer (e.g. the constants)
 you can subclass the relevant factory method.
 
-[Renderer]: /reference/blockly.blockrendering.renderer
+[Renderer]: /reference/blockly.blockrendering_namespace.renderer_class
 [constants]: /guides/create-custom-blocks/renderers/concepts/constants
 [render-info]: /guides/create-custom-blocks/renderers/concepts/info
 [path-object]: /guides/create-custom-blocks/renderers/concepts/path-object
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/rows.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/rows.mdx
index f10e15bdeac..bf4332b9b24 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/rows.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/concepts/rows.mdx
@@ -48,8 +48,8 @@ The bounds of the row spacers are determined by the
 [render info][render-info] itself. After measuring all of the rows of the block,
 the [render info][render-info] inserts spaces of its chosen size between rows.
 
-[Row]: /reference/blockly.blockrendering.row
-[RowSpacer]: /reference/blockly.blockrendering.spacerrow
+[Row]: /reference/blockly.blockrendering_namespace.row_class
+[RowSpacer]: /reference/blockly.blockrendering_namespace.spacerrow_class
 [render-info]: /guides/create-custom-blocks/renderers/concepts/info
 [external-vs-inline]: /guides/create-custom-blocks/define/inline-vs-external
 [element]: /guides/create-custom-blocks/renderers/concepts/elements
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation.mdx
index b78babdf5a5..c7938cdeb60 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation.mdx
@@ -89,16 +89,16 @@ const workspace = Blockly.inject(blocklyDiv, {
 });
 ```
 
-[Renderer]: /reference/blockly.blockrendering.renderer
+[Renderer]: /reference/blockly.blockrendering_namespace.renderer_class
 [renderer-concept]: /guides/create-custom-blocks/renderers/concepts/renderer
 [base-renderer-image]: /images/rendering/renderers/base-renderer.png
 [built-in-renderers]: /guides/create-custom-blocks/renderers/overview#built-in-renderers
 [renderer-component]: /guides/create-custom-blocks/renderers/concepts/overview
 [connection-shape]: /guides/create-custom-blocks/renderers/create-custom-renderers/connection-shapes
 [constants]: /guides/create-custom-blocks/renderers/concepts/constants
-[makeConstants]: /reference/blockly.blockrendering.renderer.makeconstants_
-[makeRenderInfo]: /reference/blockly.blockrendering.renderer.makerenderinfo_
-[makePathObject]: /reference/blockly.blockrendering.renderer.makepathobject
-[makeDrawer]: /reference/blockly.blockrendering.renderer.makedrawer_
+[makeConstants]: /reference/blockly.blockrendering_namespace.renderer_class.makeconstants__method
+[makeRenderInfo]: /reference/blockly.blockrendering_namespace.renderer_class.makerenderinfo__method
+[makePathObject]: /reference/blockly.blockrendering_namespace.renderer_class.makepathobject_method
+[makeDrawer]: /reference/blockly.blockrendering_namespace.renderer_class.makedrawer__method
 [inject-config]: /guides/configure/configuration_struct
 [custom-renderer-codelab]: /codelabs/custom-renderer/codelab-overview
diff --git a/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/connection-shapes.mdx b/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/connection-shapes.mdx
index eedfa5567ba..e1329366b50 100644
--- a/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/connection-shapes.mdx
+++ b/packages/docs/docs/guides/create-custom-blocks/renderers/create-custom-renderers/connection-shapes.mdx
@@ -307,27 +307,27 @@ export class Drawer extends Blockly.blockRendering.Drawer {
 [internal-inputs-image]: /images/rendering/connection-shapes/internal-inputs.png
 [basic-implementation]: /guides/create-custom-blocks/renderers/create-custom-renderers/basic-implementation
 [constants]: /guides/create-custom-blocks/renderers/concepts/constants
-[BaseConstants]: /reference/blockly.blockrendering.constantprovider
-[GerasConstants]: /reference/blockly.geras.constantprovider
-[ZelosConstants]: /reference/blockly.zelos.constantprovider
-[NOTCH_WIDTH]: /reference/blockly.blockrendering.constantprovider.notch_width
-[NOTCH_HEIGHT]: /reference/blockly.blockrendering.constantprovider.notch_height
-[TAB_WIDTH]: /reference/blockly.blockrendering.constantprovider.tab_width
-[TAB_HEIGHT]: /reference/blockly.blockrendering.constantprovider.tab_height
+[BaseConstants]: /reference/blockly.blockrendering_namespace.constantprovider_class
+[GerasConstants]: /reference/blockly.geras_namespace.constantprovider_class
+[ZelosConstants]: /reference/blockly.zelos_namespace.constantprovider_class
+[NOTCH_WIDTH]: /reference/blockly.blockrendering_namespace.constantprovider_class.notch_width_property
+[NOTCH_HEIGHT]: /reference/blockly.blockrendering_namespace.constantprovider_class.notch_height_property
+[TAB_WIDTH]: /reference/blockly.blockrendering_namespace.constantprovider_class.tab_width_property
+[TAB_HEIGHT]: /reference/blockly.blockrendering_namespace.constantprovider_class.tab_height_property
 [path-object]: /guides/create-custom-blocks/renderers/concepts/path-object
-[makeNotch]: /reference/blockly.blockrendering.constantprovider.makenotch
-[makePuzzleTab]: /reference/blockly.blockrendering.constantprovider.makepuzzletab
+[makeNotch]: /reference/blockly.blockrendering_namespace.constantprovider_class.makenotch_method
+[makePuzzleTab]: /reference/blockly.blockrendering_namespace.constantprovider_class.makepuzzletab_method
 [connection-check]: /guides/create-custom-blocks/inputs/connection-checks
-[shapeFor]: /reference/blockly.blockrendering.constantprovider.shapefor
+[shapeFor]: /reference/blockly.blockrendering_namespace.constantprovider_class.shapefor_method
 [basic-shapes]: #basic-shapes
 [custom-input]: /guides/create-custom-blocks/inputs/creating-custom-inputs
 [measurable]: /guides/create-custom-blocks/renderers/concepts/overview#block-measurables
-[InputConnection]: /reference/blockly.blockrendering.inputconnection
+[InputConnection]: /reference/blockly.blockrendering_namespace.inputconnection_class
 [render-info]: /guides/create-custom-blocks/renderers/concepts/info
-[addInput]: /reference/blockly.blockrendering.renderinfo.addinput_
+[addInput]: /reference/blockly.blockrendering_namespace.renderinfo_class.addinput__method
 [row]: /guides/create-custom-blocks/renderers/concepts/rows
-[shouldStartNewRow]: /reference/blockly.blockrendering.renderinfo.shouldstartnewrow_
+[shouldStartNewRow]: /reference/blockly.blockrendering_namespace.renderinfo_class.shouldstartnewrow__method
 [drawer]: /guides/create-custom-blocks/renderers/concepts/drawer
-[drawOutline]: /reference/blockly.blockrendering.drawer.drawoutline_
-[drawInternals]: /reference/blockly.blockrendering.drawer.drawinternals_
+[drawOutline]: /reference/blockly.blockrendering_namespace.drawer_class.drawoutline__method
+[drawInternals]: /reference/blockly.blockrendering_namespace.drawer_class.drawinternals__method
 [svg-path]: https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Paths