---
url: /excel-addin/how-to-run-cards-in-excel.md
description: How to run a Card against a cell range in the MODLR Excel Add-in.
---

# How to run Cards in Excel

1. Highlight the range you would like to allow a card to be executed against.

![Highlight the range](/excel-run-card-1.png)

:::tip
This only works from cells containing a simple CubeGet, e.g. `=CubeGet(args)`. It won't work if the CubeGet is wrapped in other logic, e.g. `=IF(check, CubeGet(args), otherOutcome)`.

The context from the CubeGet is passed to the card when it runs. For example, if the CubeGet references the time element "2026 - Jan", the card will execute with a time context of "2026 - Jan".
:::

2. Right click the selected range and open the MODLR menu, then click **Add Card to Range**.

![Add Card to Range](/excel-run-card-2.png)

3. The Card is now ready to be run in this Excel workbook.

![Card ready to run](/excel-run-card-3.png)

4. To run the card, right click on one of the cells in the range and open the MODLR menu, then click **Execute Card**. This will render the card in a popup window, the same as it would appear in the MODLR Gateway or Frontend.

![Execute Card](/excel-run-card-4.png)

5. Alternatively, click **Execute Card as worksheet**. Where possible, the card will open in a new tab in your current workbook, and data from the card will appear directly in the Workbook.

![Execute Card as worksheet](/excel-run-card-5.png)

:::tip
If the card selected contains a table component, you can select **Execute Card as worksheet** to dump the card table contents into a new sheet on your Excel file.
:::

**Related entries:** [Cards in Excel](/excel-addin/cards-in-excel), [Cards Guide](/card-guides/)
