The dimension parameter declares a new dimension and specifies a name for that dimension.
The name must meet the following requirements:
It must be unique within any given view.
It must consist of characters a through z, 0 through 9, or _. The dimension name is case-sensitive. Because of this, we recommend using a consistent lowercase name for all LookML objects, including dimensions.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[],[],null,["# dimension\n\nUsage\n-----\n\n```\nview: view_name {\n dimension: field_name { ... }\n}\n```\n\nDefinition\n----------\n\nThe `dimension` parameter declares a new dimension and specifies a name for that dimension.\n\nThe name must meet the following requirements:\n\n- It must be unique within any given view.\n- It must consist of characters `a` through `z`, `0` through `9`, or `_`. The dimension name is case-sensitive. Because of this, we recommend using a consistent lowercase name for all LookML objects, including dimensions.\n- It must start with a letter.\n\nThere are many types of dimensions, as discussed further on the [Dimension, filter, and parameter types](/looker/docs/2512/reference/param-dimension-filter-parameter-types) documentation page.\n\nSubparameters for `dimension`\n-----------------------------\n\nSee the [Field parameters](/looker/docs/2512/reference/param-field#example_usage) reference page for a list of subparameters that are available for LookML fields.\n| **Tip:** You can use the [Quick Help panel](/looker/docs/2512/looker-ide#quick_help_panel) in the Looker IDE to quickly see the available subparameters for a given LookML field. Click a LookML parameter in the IDE editor panel to update the **Quick Help** panel to display the supported options and subparameters for that LookML element. Also, you can click a parameter name in the **Quick Help** panel to open the Looker documentation page for that parameter.\n\nExamples\n--------\n\nCreate an `id` and a `supplier_name` dimension in a view named `products`: \n\n view: products {\n dimension: id {\n primary_key: yes\n sql: ${TABLE}.id ;;\n }\n dimension: supplier_name {\n sql: ${TABLE}.supplier_name ;;\n }\n }"]]