---
url: /card-guides/text.md
description: The Text component provides the ability to include text within the card.
---

# Text

The Text component provides the ability to include text within the card.

## Common Use Properties

* **Text Property**
  The text property can be driven by formulas by clicking on the calculator symbol. Formula For more information the small to reference data stored in the model.

* **Format Property**
  Applies a number format pattern (`#,##0`, `0.0%`, and so on) to a numeric value shown in the Text property. See [MODLR Number Formats](/technical/modlr-formats) for the full pattern reference, including how each pattern maps to the equivalent Workview `Format` Set Instruction. For a pattern that needs to be computed conditionally rather than fixed, wrap the value in [`NUMBERFORMAT`](/cube-functions/numberformat) within the Text formula instead - e.g. `NUMBERFORMAT(LINK("Sales", ["Revenue"]), "#,##0")`.

* **Href Property**
  The Href property allows the users to embed a link within the card

- **External Href Link**
  An external link refers to a link that will link the url of an external (outside of the model application) webpage. For the link to open an external webpage, `https://` must be added to the beginning of the URL you wish to link. If `https://` is not included in the href property, the link will be from the current application domain from which the card has been implemented.

  > **Example:**
  > For this example, the URL of the application we will be referring to is:
  > `https://card-demo.modlr.cloud/`
  > The example screen will exist at the following url:
  > `https://card-demo.modlr.cloud/example-screen/`
  >
  > If the example screen contained a text component which had the following Href property `www.exampleURL.com`, when clicking the link, the URL to be opened would be added to the current directory path and would look like the following:
  > `https://card-demo.modlr.cloud/example-screen/www.exampleURL.com`
  >
  > If the example screen Href property instead contained `https:/www.exampleURL.com`, the URL would instead open up the following:
  > `https:/www.exampleURL.com`

* **Internal Href Link**
  An internal link refers to a link that will be linked internally within the application. Internal links forgo the required `https://` that is needed for external links. If extending the current path of the URL, the extension can be input straight into the Href property.

  >

  > **Example 1:**
  > For this example, the card that contains the text component and Href property will exist in the example screen at the following url:
  > `https://card-demo.modlr.cloud/example-screen/`
  >
  > If the example screen contained a text component that had the following Href property ‘example-screen-extension’, when clicking the link, the URL to be opened would be added to the current directory path and would look like the following:
  > `https://card-demo.modlr.cloud/example-screen/example-screen-extension`

  > **Example 2:**
  > For this example, we will be referring to the same URL outlined in Internal Href Example 1.
  >
  > If it was intended for the URL to instead link to an alternative pathway from the application domain, such as:
  > `https://card-demo.modlr.cloud/alternative-example-screen/`
  >
  > The Href property would have to be formula-driven; this would be done by clicking on the small calculator as per Fig. 2. Href Formula.
  > The following would need to be added to the formula:
  > `/alternative-example-screen/`