diff --git a/www/packages/docs-ui/src/components/ExpandableNotice/index.tsx b/www/packages/docs-ui/src/components/ExpandableNotice/index.tsx
index 89f53ca867..daced4ffef 100644
--- a/www/packages/docs-ui/src/components/ExpandableNotice/index.tsx
+++ b/www/packages/docs-ui/src/components/ExpandableNotice/index.tsx
@@ -2,7 +2,7 @@ import React from "react"
 import { Badge, Link, Tooltip } from "@/components"
 
 export type ExpandableNoticeProps = {
-  type: "request" | "method"
+  type: "request" | "method" | "workflow"
   link: string
   badgeContent?: React.ReactNode
   badgeClassName?: string
@@ -19,8 +19,8 @@ export const ExpandableNotice = ({
       tooltipChildren={
         <>
           If this {type} accepts an <code>expand</code>{" "}
-          {type === "request" ? "parameter" : "property or option"},
-          <br /> this field can be <Link href={link}>expanded</Link> into an
+          {type === "request" ? "parameter" : "parameter or property"},
+          <br /> this relation can be <Link href={link}>expanded</Link> into an
           object.
         </>
       }
diff --git a/www/packages/docs-ui/src/components/TypeList/Items/index.tsx b/www/packages/docs-ui/src/components/TypeList/Items/index.tsx
index 05298983db..077bedc45f 100644
--- a/www/packages/docs-ui/src/components/TypeList/Items/index.tsx
+++ b/www/packages/docs-ui/src/components/TypeList/Items/index.tsx
@@ -25,6 +25,7 @@ import { useIsBrowser, useSiteConfig } from "../../.."
 
 type CommonProps = ParentCommonProps & {
   level?: number
+  referenceType?: "method" | "workflow"
 }
 
 type TypeListItemProps = {
@@ -39,6 +40,7 @@ const TypeListItem = ({
   expandUrl,
   elementKey,
   sectionTitle,
+  referenceType = "method",
 }: TypeListItemProps) => {
   const isBrowser = useIsBrowser()
   const pathname = usePathname()
@@ -227,9 +229,9 @@ const TypeListItem = ({
             )}
             {item.expandable && (
               <ExpandableNotice
-                type="method"
+                type={referenceType}
                 link={expandUrl || "#"}
-                badgeClassName="!p-0 leading-none"
+                badgeClassName="!p-docs_0.25 block leading-none"
                 badgeContent={<ArrowsPointingOutMini />}
               />
             )}
diff --git a/www/utils/packages/typedoc-generate-references/src/constants/merger-custom-options/medusa.ts b/www/utils/packages/typedoc-generate-references/src/constants/merger-custom-options/medusa.ts
index c9c4a2a740..7c51a85c88 100644
--- a/www/utils/packages/typedoc-generate-references/src/constants/merger-custom-options/medusa.ts
+++ b/www/utils/packages/typedoc-generate-references/src/constants/merger-custom-options/medusa.ts
@@ -3,10 +3,6 @@ import { FormattingOptionsType } from "types"
 const medusaOptions: FormattingOptionsType = {
   "^medusa/": {
     maxLevel: 2,
-    parameterComponentExtraProps: {
-      expandUrl:
-        "https://docs.medusajs.com/development/entities/repositories#retrieving-a-list-of-records",
-    },
   },
   "^medusa/classes/medusa\\.(Store*|Admin*)": {
     reflectionGroups: {
diff --git a/www/utils/packages/typedoc-generate-references/src/constants/merger-options.ts b/www/utils/packages/typedoc-generate-references/src/constants/merger-options.ts
index 869c56c44d..6aee815213 100644
--- a/www/utils/packages/typedoc-generate-references/src/constants/merger-options.ts
+++ b/www/utils/packages/typedoc-generate-references/src/constants/merger-options.ts
@@ -50,6 +50,10 @@ const mergerOptions: Partial<TypeDocOptions> = {
       parameterStyle: "component",
       parameterComponent: "TypeList",
       mdxImports: [`import { TypeList } from "docs-ui"`],
+      parameterComponentExtraProps: {
+        expandUrl:
+          "https://docs.medusajs.com/v2/advanced-development/data-models/manage-relationships#retrieve-records-of-relation",
+      },
     },
     internal: {
       maxLevel: 1,