# Dimension Setup

## Based on Tags

Just like [**Units**](https://help.taglo.io/units), Dimensions are based on [**Tags**](https://help.taglo.io/tags). In fact, a Dimension *is* a Tag: an `Abstract` Tag with `Concrete` Children.

> For example, `Sales Region` could be an example of an `Abstract` Tag, which has 4 `Concrete` Tag Children (`North`, `East`, `South`, `West`).

{% hint style="info" %}
For a more detailed explanation of Abstract and Concrete Tags, see [**here**](https://help.taglo.io/tags/introduction-to-tags#abstract-vs.-concrete).
{% endhint %}

## Selecting Dimensions

In the Variable wizard [**Setup Step**](https://help.taglo.io/variables/variable-basics/variable-setup#dimensions), you can select/create/edit any Dimensions to apply to your Variable.

In the example screenshot below, the user is shown a list of Dimensions:

1. By default, the list is filtered to just show Dimensions (`Abstract` Tags) with children <mark style="color:green;">**(1)**</mark>. Remove this filter if you want to search through all Tags.
2. Dimensions that are already used in your Model are indicated with an asterisk, and shown at the top of the list <mark style="color:green;">**(2)**</mark>, for easy access.

<figure><img src="https://2847533834-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVy65sax6FVoNo2UTlJ0x%2Fuploads%2FzMsGjvp06CuPnx0ZbXbQ%2Fimage.png?alt=media&#x26;token=47d4d806-bf4f-48b1-8e88-37fe7c353914" alt="Screenshot showing the Dimensions step of the Variables wizard"><figcaption><p>Dimension step of the Variable wizard</p></figcaption></figure>

### Selecting repeated Dimensions

You can select the same Dimension multiple times. When you do so, you will be asked to select a [**Tag Property**](https://help.taglo.io/tags/advanced-tags#tag-properties) for each instance of the Dimension, as shown in the screenshot below. Each instance must have a different Tag Property selected - this enables Models to differentiate between the two instances.

<figure><img src="https://2847533834-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVy65sax6FVoNo2UTlJ0x%2Fuploads%2FBqd88ToyG0cGGOggs0EN%2Fimage.png?alt=media&#x26;token=a8d5026e-3747-4aad-bf20-128a279d46d2" alt="Screenshot showing the Dimensions step of the Variable wizard. Two &#x22;Widget Supplier&#x22; dimensions have been selected - one has had the &#x22;From&#x22; Tag Property applied, and the other has had the &#x22;To&#x22; Tag Property applied."><figcaption><p>Selecting repeated Dimensions</p></figcaption></figure>

To select a Tag Property, click on the dropdown and select from an existing Tag Property, or create a new one, as shown in the screenshot below.

<figure><img src="https://2847533834-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVy65sax6FVoNo2UTlJ0x%2Fuploads%2F9jWx08ZDa2EksLPIAAmU%2Fimage.png?alt=media&#x26;token=dced80cd-02c6-42da-b67f-1b0530d17189" alt="Screenshot showing the Tag Property dropdown control available when multiple instances of the same Dimension are selected"><figcaption><p>The Tag Property control</p></figcaption></figure>

These Tag Properties will be visible in the Variable preview, and will indicate how the heading of each Variable item should be interpreted.&#x20;

In the below example, the Variable calculates the movement of customers between three suppliers - **from** each of the three suppliers, **to** each of the three suppliers. The titles of each row in Values table <mark style="color:green;">**(2)**</mark> can be interpreted as the "From" supplier followed by the "To" supplier, as indicated by the Dimensions description at <mark style="color:green;">**(1)**</mark>.

<figure><img src="https://2847533834-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVy65sax6FVoNo2UTlJ0x%2Fuploads%2F0mWJmcoa6Nwk8MFMCLCX%2Fimage.png?alt=media&#x26;token=01e9a6ea-015a-48c0-8a0d-ee98c8efaf22" alt="" width="563"><figcaption><p>Preview of Variable with repeated Dimensions</p></figcaption></figure>

## Creating/Editing Dimensions

To create a Dimension, just add a new item to the list. Choose a name for the Dimension, and the [**Namespace**](https://help.taglo.io/using-taglo-software/namespaces) the Dimension should belong to. By default, the new Dimension will be added to the same Namespace as your Model.

{% hint style="info" %}
When you create a new Dimension, you are actually creating a new `Abstract` [**Tag**](https://help.taglo.io/tags). You can use the Tags Application to manage Tags (and their associated Dimensions) all in one place.
{% endhint %}

As shown below, you can enter new Child names for your Dimension directly into the text box <mark style="color:green;">**(1)**</mark>, and a new `Concrete` Tag will be created for each one. You can edit existing Children by hovering over the Child, and clicking on the Edit Tag <img src="https://2847533834-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVy65sax6FVoNo2UTlJ0x%2Fuploads%2FTtTB69OZ3vca2DhdghhW%2Fimage.png?alt=media&#x26;token=e7e2226c-68d4-4176-a842-ad66af0d5ecd" alt="" data-size="line">button that appears <mark style="color:green;">**(2)**</mark>. This is where you can edit the Short Name property of the Tag, which is the name that will be displayed when the Child appears in your Model.

<figure><img src="https://2847533834-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVy65sax6FVoNo2UTlJ0x%2Fuploads%2FIhxMZtlcZ2sfp8VmpmDM%2Fimage.png?alt=media&#x26;token=eb97f1af-145a-4efd-9dcf-245346046bba" alt="Screenshot showing the Dimension editor"><figcaption><p>Editing a Dimension</p></figcaption></figure>