# Components

## Actions

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Action menu</strong></td><td>An action menu shows a list of items presenting the user with actions that can have an immediate effect, or a redirection to another section of the Mirakl platform.</td><td><a href="/files/OTYLyfmOdh8DzfqwkbCU">/files/OTYLyfmOdh8DzfqwkbCU</a></td><td><a href="/pages/PFeFbEZituCUe1XOHUkO">/pages/PFeFbEZituCUe1XOHUkO</a></td></tr><tr><td><strong>Buttons</strong></td><td>A central component to guide users through their experience in the platform. They trigger actions and let users know what their options are.</td><td><a href="/files/xICqKBu24KD6D5NaXx4U">/files/xICqKBu24KD6D5NaXx4U</a></td><td><a href="/pages/Q9OUfz1g17NjKLDLN67M">/pages/Q9OUfz1g17NjKLDLN67M</a></td></tr><tr><td><strong>Button group</strong></td><td>Button group is used to gather multiple actions.</td><td><a href="/files/xcgVz65hojApz1ZNXYwD">/files/xcgVz65hojApz1ZNXYwD</a></td><td><a href="/pages/47rTZNUygDR9m7vr0N6f">/pages/47rTZNUygDR9m7vr0N6f</a></td></tr><tr><td><strong>File download</strong></td><td>This component allows users to download a file from Mirakl.</td><td><a href="/files/ud7Zb3luY0EI88pyAEtP">/files/ud7Zb3luY0EI88pyAEtP</a></td><td><a href="/pages/Hzp2Iffj8XC61WOYvuiW">/pages/Hzp2Iffj8XC61WOYvuiW</a></td></tr><tr><td><strong>Save bar</strong></td><td>A Save Bar is an action bar that sticks to the bottom of the viewport as you scroll. It contains actions related to a page and allow users to scroll without loosing visibility on the different actions</td><td><a href="/files/0h1zPZBkBqUZJDVeVLO0">/files/0h1zPZBkBqUZJDVeVLO0</a></td><td><a href="/pages/Z8HhM6VG9p6OdmPEJWJF">/pages/Z8HhM6VG9p6OdmPEJWJF</a></td></tr><tr><td><strong>Tasklist</strong></td><td>Tasklists are designed to display multiple tasks users will have to complete to finalize a complex process (e.g. store or profile creation).</td><td><a href="/files/yt1nE2QQZjFh4xlGPe0s">/files/yt1nE2QQZjFh4xlGPe0s</a></td><td><a href="/pages/yF5TnkqxwsFBO19iw5yQ">/pages/yF5TnkqxwsFBO19iw5yQ</a></td></tr><tr><td><strong>Toolbar</strong></td><td>Toolbar allows users to filter and manage the display of the content a page</td><td><a href="/files/nNepiYmEbcqudUUwRbzZ">/files/nNepiYmEbcqudUUwRbzZ</a></td><td><a href="/pages/g9flKMasD5KGarwVG1wb">/pages/g9flKMasD5KGarwVG1wb</a></td></tr></tbody></table>

***

## Datalist

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Datalist</strong></td><td>Datalists display objects of the same type in a lean and clear way.</td><td></td><td><a href="/pages/Jolr4RefXUWMkBzgqccZ">/pages/Jolr4RefXUWMkBzgqccZ</a></td><td><a href="/files/y69lTN710wGQA9CJvnnd">/files/y69lTN710wGQA9CJvnnd</a></td></tr></tbody></table>

***

## Datatable

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Datatable</strong></td><td>Datatables are made to display information in a consistent way made to compare data easily.</td><td></td><td><a href="/pages/iiM5zl5gHhrJ23AFRgha">/pages/iiM5zl5gHhrJ23AFRgha</a></td><td><a href="/files/VFGAQerut5zRLmOC8vgG">/files/VFGAQerut5zRLmOC8vgG</a></td></tr></tbody></table>

***

## Feedback

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Alert</strong></td><td>Alerts highlight important information that needs to be communicated quickly to the user.</td><td></td><td><a href="/pages/chB3bqh9dSxOjYy72yxL">/pages/chB3bqh9dSxOjYy72yxL</a></td><td><a href="/files/yDh8Ng7y2NO9WuGsoAey">/files/yDh8Ng7y2NO9WuGsoAey</a></td></tr><tr><td><strong>Activity loader</strong></td><td>A component that indicates to users that we're processing their data or that a page is loading.</td><td></td><td><a href="/pages/nsDHeOYi2Ml3ereokKCv">/pages/nsDHeOYi2Ml3ereokKCv</a></td><td><a href="/files/xKvH54IZFdlLCzMefhvJ">/files/xKvH54IZFdlLCzMefhvJ</a></td></tr><tr><td><strong>Badge</strong></td><td>Badges are used to show the status of an object or the result of an action that has been performed.</td><td></td><td><a href="/pages/2oQ6erK7nDMlXy7W3UlC">/pages/2oQ6erK7nDMlXy7W3UlC</a></td><td><a href="/files/X0Or3f6n5MmPVu0WKegy">/files/X0Or3f6n5MmPVu0WKegy</a></td></tr><tr><td><strong>Empty state</strong></td><td>Empty states should be used when the expected content cannot be displayed. It sets expectations and indicates the reasons for this blank space.</td><td></td><td><a href="/pages/D5y6uvOZJoy61X1ZzL4U">/pages/D5y6uvOZJoy61X1ZzL4U</a></td><td><a href="/files/XvylezXdi7AQL3GnvPOA">/files/XvylezXdi7AQL3GnvPOA</a></td></tr><tr><td><strong>Snackbar</strong></td><td>A discreet but efficient way to convey feedback on the outcome of an action.</td><td></td><td><a href="/pages/AFO96vYTJCwWjlfNVUNy">/pages/AFO96vYTJCwWjlfNVUNy</a></td><td><a href="/files/2cbIZDCD50PiRzeQQSF6">/files/2cbIZDCD50PiRzeQQSF6</a></td></tr></tbody></table>

***

## Forms

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Fields</strong></td><td>Fields component allow users to enter a text. They will provide answers we cannot foresee unlike Pickers component.</td><td></td><td><a href="/pages/ARd3cpbXfcBRil2jZZWa">/pages/ARd3cpbXfcBRil2jZZWa</a></td><td><a href="/files/LJWP9GL5gSExS2C75A0Y">/files/LJWP9GL5gSExS2C75A0Y</a></td></tr><tr><td><strong>Pickers</strong></td><td>Pickers allow users to select content from a set of values, usually presented in a list or dropdown menu.</td><td></td><td><a href="/pages/OWlRuwKZ6Cmy32CK3gLV">/pages/OWlRuwKZ6Cmy32CK3gLV</a></td><td><a href="/files/aEMRN7Vu6dWNM3KAG8ET">/files/aEMRN7Vu6dWNM3KAG8ET</a></td></tr><tr><td><strong>Selection controls</strong></td><td>Selection controls are specific components to let users control different kinds of options, settings, or situations.</td><td></td><td><a href="/pages/zx7aZ4AQUpzte84uERxu">/pages/zx7aZ4AQUpzte84uERxu</a></td><td><a href="/files/EqQR5WHDhI3lxSVLCuOa">/files/EqQR5WHDhI3lxSVLCuOa</a></td></tr><tr><td><strong>Tree</strong></td><td>A tree helps showcase data in a hierarchical way, either for selection or navigation.</td><td></td><td><a href="/pages/DwVDFnpsWcJcVhhVRPcL">/pages/DwVDFnpsWcJcVhhVRPcL</a></td><td><a href="/files/h3UJgWVcoz88YO4f7v76">/files/h3UJgWVcoz88YO4f7v76</a></td></tr></tbody></table>

***

## Images

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Illustrations</strong></td><td>Our illustrations have a visual and emotional impact in order to bring optimism, friendliness and engagement to users.</td><td></td><td><a href="/files/0xAhmqoxctdHZ7duabCY">/files/0xAhmqoxctdHZ7duabCY</a></td><td><a href="/pages/kTbb4MWQNXQ5GVjvcTwM">/pages/kTbb4MWQNXQ5GVjvcTwM</a></td></tr><tr><td><strong>Icons</strong></td><td>Icons provide visual help to users and illustrate key concepts.</td><td></td><td><a href="/files/25PY0zEXh8ViGVM9cllx">/files/25PY0zEXh8ViGVM9cllx</a></td><td><a href="/pages/54xQ4RMZYM4hPitGN2mv">/pages/54xQ4RMZYM4hPitGN2mv</a></td></tr><tr><td><strong>Media</strong></td><td>Media component is used to display images.</td><td></td><td><a href="/files/M2iXrfy9PdDoeEWw9Osk">/files/M2iXrfy9PdDoeEWw9Osk</a></td><td><a href="/pages/l3PzNLLTCIrAbKhdw8sn">/pages/l3PzNLLTCIrAbKhdw8sn</a></td></tr></tbody></table>

***

## Navigation

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Hyperlink</strong></td><td>Hyperlinks are anchor tags users can interact with to navigate to other pages.</td><td></td><td><a href="/files/Bqw58Z3VdVPclt6e5rH6">/files/Bqw58Z3VdVPclt6e5rH6</a></td><td><a href="/pages/9qAmxTJBNvqY61tADvPD">/pages/9qAmxTJBNvqY61tADvPD</a></td></tr><tr><td><strong>Page title</strong></td><td>The first thing users see before interacting with the page. It provides the core information users need when viewing the page.</td><td></td><td><a href="/files/qh4C0lvSGwMeBfb1mRKR">/files/qh4C0lvSGwMeBfb1mRKR</a></td><td><a href="/pages/xo1z1t3P5jW8xaqw9cLl">/pages/xo1z1t3P5jW8xaqw9cLl</a></td></tr><tr><td><strong>Sidebar</strong></td><td>Our sidebar menu displays the primary navigation and provides access to the main sections of the platform.</td><td></td><td><a href="/files/apr2n1uYtFrDWN04jRho">/files/apr2n1uYtFrDWN04jRho</a></td><td><a href="/pages/GLITmOBREvoNSGO2T59N">/pages/GLITmOBREvoNSGO2T59N</a></td></tr><tr><td><strong>Top bar</strong></td><td>Top bar allows operators and sellers to switch between our different tools and access their profile.</td><td></td><td><a href="/files/2S3M2L5GsAnOQXmkJ6Vr">/files/2S3M2L5GsAnOQXmkJ6Vr</a></td><td><a href="/pages/xcKGBpSYG670Bjjnj36O">/pages/xcKGBpSYG670Bjjnj36O</a></td></tr></tbody></table>

***

## Overlays

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Modal</strong></td><td>A modal displays content that requires user interaction in a layer that shows up on top of the current context. Modals block access to the rest of the page and force user interaction.</td><td></td><td><a href="/files/MnKfxW59uveYm8gplbJh">/files/MnKfxW59uveYm8gplbJh</a></td><td><a href="/pages/4nRx4QSkhYnlE9J3VJhX">/pages/4nRx4QSkhYnlE9J3VJhX</a></td></tr><tr><td><strong>Popover</strong></td><td>An overlay for larger amounts of data.</td><td></td><td><a href="/files/AhiHgTiw27twmFiGkGC2">/files/AhiHgTiw27twmFiGkGC2</a></td><td><a href="/pages/uWWzP1khPciOavpAiQsh">/pages/uWWzP1khPciOavpAiQsh</a></td></tr><tr><td><strong>Tooltip</strong></td><td>An overlay for small amounts of data.</td><td></td><td><a href="/files/553VGHcZsf6ANtbZcYUu">/files/553VGHcZsf6ANtbZcYUu</a></td><td><a href="/pages/DRdzhTLPSN0bYKDKcxFt">/pages/DRdzhTLPSN0bYKDKcxFt</a></td></tr></tbody></table>

***

## Structure

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Global layout</strong></td><td>Global layout is the way we arrange elements on a page to create a consistent experience for the user.</td><td></td><td><a href="/pages/qNCLMb3zHHLfqBQUxBu6">/pages/qNCLMb3zHHLfqBQUxBu6</a></td><td><a href="/files/OUH6vpVGwRzCaZeIObsi">/files/OUH6vpVGwRzCaZeIObsi</a></td></tr><tr><td><strong>Panel</strong></td><td>The key component to structure content on Mirakl.</td><td></td><td><a href="/pages/PAar1ocuQm03t1PZVgE1">/pages/PAar1ocuQm03t1PZVgE1</a></td><td><a href="/files/I4YPYLXk4jSTx8lbBFm3">/files/I4YPYLXk4jSTx8lbBFm3</a></td></tr><tr><td><strong>Card</strong></td><td>Cards are a great way to add some hierarchy and organization to a panel.</td><td></td><td><a href="/pages/mIiFxfBSkfTkPA0CUKn2">/pages/mIiFxfBSkfTkPA0CUKn2</a></td><td><a href="/files/JztMFfBKYP6CM4Ar7lSp">/files/JztMFfBKYP6CM4Ar7lSp</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://design.mirakl.com/design/components.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
