diff --git a/src/types/ImageItemConfig.ts b/src/types/ImageItemConfig.ts
index e668d1b..e89ef43 100644
--- a/src/types/ImageItemConfig.ts
+++ b/src/types/ImageItemConfig.ts
@@ -92,6 +92,13 @@ export type ImageGradientConfig = Partial<Pick<ImageRectConfig,
   type?: 'axial' | 'conic' | 'radial'
 };
 
+/**
+ * A configuration object for images.
+ * 
+ * This configuration object is used to either programmatically create images,
+ * (e.g. gradients, rects, SFSymbols icons, etc)., or refer to existing image assets
+ * in the project (e.g. js image assets, XCAssets).
+ */
 export type ImageItemConfig = {
   type: 'IMAGE_ASSET';
   /** The corresponding key of asset item in the asset catalog */
diff --git a/src/types/MenuConfig.ts b/src/types/MenuConfig.ts
index e5feed1..f219acf 100644
--- a/src/types/MenuConfig.ts
+++ b/src/types/MenuConfig.ts
@@ -29,15 +29,26 @@ export type MenuActionConfig = {
   menuAttributes?: MenuAttributes;
 
   discoverabilityTitle?: string;
-  icon?: IconConfig;
-  
-  // subtitle - TODO: TBA
+
+  /**
+   * `IconConfig` is deprecated, use `ImageItemConfig` instead.
+   * Used to configure what icon or image to show in the menu action.
+   */
+  icon?: IconConfig | ImageItemConfig;
 };
 
 export type MenuConfig = {
   menuTitle: string;
-  
+
   menuOptions?: Array<UIMenuOptions>;
   menuItems?: Array<MenuConfig | MenuActionConfig>;
-  icon?: IconConfig;
+
+  /**
+   * `IconConfig` is deprecated, use `ImageItemConfig` instead.
+   * Used to configure what icon or image to show in the submenu.
+   * 
+   * Note: The icon is only shown if the menu is a submenu. If the menu
+   * is the root menu, the icon will not be visible.
+   */
+  icon?: IconConfig | ImageItemConfig;
 };
\ No newline at end of file