---
schema_version: "1"
id: a44277adc67e7b6d6bfa16b1da2d4859a9985067059592e8839102f560238cc2
title: Dimensions and Derived Dimensions in XMD
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/bi_dev_guide_xmd/guides/reference/bi-xmd-reference-dimensions.md
canonical_url: https://developer.salesforce.com/docs/analytics/bi-dev-guide-xmd/guide/bi-xmd-reference-dimensions.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 26dc24f0c7439bafea009148b7c6006b22cb63f2e5068c0f3f85a47fb1df0336
products:
  - Analytics Extended Metadata (XMD) Developer Guide
  - analytics
---

# Dimensions and Derived Dimensions in XMD

You can add an action menu to a dimension value in Analytics lens and dashboard charts and tables. Users can then open a record and perform record-level actions. The available XMD parameters are the same for dimensions and derived dimensions.

This XMD snippet shows the parameters used with `dimensions`.

```nolang
         "conditionalFormatting":{
            "chartColor":{
               "parameters":{
                  "values":[
                     {
                        "formatValue":"#E8963B",
                        "value":"false"
                     },
                     {
                        "formatValue":"#3AE867",
                        "value":"true"
                     }
                  ]
               },
               "referenceField":"Stage_IsAdvanced",
               "type":"categories"
            }
```

The `dimensions` and `derived dimensions` sections can have the following parameters.

## description

Description of the dataset field, up to 1,000 characters.

Example: `"description": "Region tracks where the sale was made."`

## field

Identifier for the dataset field (API name).

## label

Display name for the dataset field, up to 40 characters.

Example: `"label": "Sales Manager"`

## linkTemplateEnabled

(Boolean) Indicates whether to display the link to open a Salesforce record or URL.

## linkTemplate

URL to open when the user clicks the link in the actions menu. Overrides the default `"/{{row.recordIdField}}"`.

Example: `"linkTemplate": "/{{row.dimensionNameId}}"`

## linkTooltip

Tooltip shown when hovering over the link in Analytics lens or dashboard.

Example: `"linkTooltip": "Click to open the record"`

## members

Array of display customizations for specific dimension values.

```nolang
"members": [
  {
    "member": "USA",
    "label": "United States",
    "color": "Blue"
  },
  {
    "member": "MX",
    "label": "Mexico",
    "color": "Green"
  }
]
```

## recordIdField

Dataset field containing the Salesforce record ID for record-level actions.

## recordOrganizationField

Dataset field containing the org ID used for multi-org record-level actions.

## recordDisplayFields

Array of dataset fields shown when multiple records match an action.

```nolang
"field": "AccountId.Name",
"recordIdField": "AccountId.Id",
"recordDisplayFields": ["Case_ID","Account_Name","Case_Owner"]
```

## salesforceActionsEnabled

(Boolean) Indicates whether the Salesforce actions menu appears on the field.

Example: `"salesforceActionsEnabled": true`

## salesforceActions

Array of actions that appear in the action menu.

```nolang
"salesforceActions": [
  {
    "enabled": true,
    "name": "FeedItem.TextPost"
  },
  {
    "enabled": true,
    "name": "FSL__LogACall"
  }
]
```

For more information, see [Perform Actions on a Salesforce Record from Analytics](https://help.salesforce.com/articleView?id=bi_dashboards_actions_configure.htm).

## showInExplorer

(Boolean) Indicates whether the dataset field can be selected from dashboard designer or explorer when creating dashboards and lenses.

Example: `"showInExplorer": true`

**See Also**

- [Change Display Labels for Dataset Fields and Values](https://developer.salesforce.com/docs/analytics/bi-dev-guide-xmd/concept/bi-xmd-change-labels.md)
- [Hide Dataset Fields from Lens and Dashboard](https://developer.salesforce.com/docs/analytics/bi-dev-guide-xmd/concept/bi-xmd-show-dataset-fields.md)
- [Change Chart Colors for Dimension Values](https://developer.salesforce.com/docs/analytics/bi-dev-guide-xmd/concept/bi-xmd-change-chart-colors.md)
- [Add Actions to Dimensions](https://developer.salesforce.com/docs/analytics/bi-dev-guide-xmd/concept/bi-xmd-add-record-level-actions.md)