Skip to main content
This page demonstrates a simple but important point: Mintlify pages are not limited to static Markdown. You can combine standard MDX content with custom coded components to build richer product demos directly inside your documentation. This section reuses one handbag Q&A scenario and one shared product dataset, then turns that same payload into many different product experiences. Each demo now lives on its own page, so the left documentation sidebar works as the primary example menu. Use this overview page as a quick map, then open the individual demos from the cards below or from the sidebar.

​
What this pattern is good for

  • Showing multiple integration outcomes without sending readers to an external demo site
  • Comparing many presentation patterns while keeping one underlying product dataset
  • Explaining how the same ActionX result can power links, cards, galleries, or follow-up actions
  • Prototyping lightweight UI ideas directly in docs before moving them into an application
  • Teaching partners and developers that Mintlify can host custom coded presentation layers inside a normal documentation page

​
Browse by category

​
Soft placement

Soft mention

Blend one subtle product suggestion into the answer before using explicit links.

Contextual entity links

Embed linked brands and product names naturally inside the answer itself.

Contextual links with ad hover

Add a tiny AD marker after the linked entity and reveal the product card on hover.

Clickable recommendation block

Turn one recommendation paragraph into a larger, softer click target.

Inline recommendation insert

Insert one compact recommendation card into the middle of a longer answer.

​
Answer-native

Text links

Keep the answer intact and only upgrade product names into links.

Inline product cards

Add visual product cards directly after the answer.

Reason chips

Explain each recommendation with compact tags.

Expandable picks

Collapse the shortlist until the user wants more detail.

Hover sync answer

Sync answer reasoning with a richer product panel.

Chat carousel

Keep the chat framing and move the products into a horizontal shelf.

​
Browsing-native

Product gallery

Render the same payload as a straightforward recommendation grid.

Editorial spotlight

Feature one hero recommendation and supporting picks.

Bento discovery grid

Use an editorial bento layout to make the catalog feel richer.

Lookbook strip

Push the imagery forward with a more lifestyle-led presentation.

Compact result shelf

Shrink recommendations into a denser page placement.

​
Decision-support

Comparison table

Compare style, occasion, and gifting logic side by side.

Attribute scorecards

Expose ranking logic with compact visual scores.

Persona matcher

Re-rank the same shortlist around different user personas.

Occasion switcher

Adapt the framing for birthdays, anniversaries, and holidays.

Shortlist compare tray

Let users save likely picks before comparing them.

​
Action-extensions

Follow-up service card

Attach a post-recommendation service module after the answer.

Gift bundle builder

Turn a recommendation into a lightweight add-on flow.

Save or share wishlist

Convert recommendations into a softer save-or-share action.

Next-step action sheet

Surface the likely next actions in a compact action layer.