---
title: "Fields"
slug: "fields"
updated: 2025-09-14T22:25:55Z
published: 2025-09-14T22:25:55Z
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fields

Query fields can be provided either as a comma delimited string, list of strings, or a list of objects. Only the last one can contain additional field properties.

```plaintext
{"fields": "date, impressions"}
{"fields": ["date", "impressions"]}
{"fields": [{"id": "date"}, {"id": "impressions"}]}
```

Please refer to data source specific field documentation for accepted ID values.

## Field properties

| Property | Type | Description |
| --- | --- | --- |
| id | string | Required. Field ID |
| key | string | Optional. Custom key to use for field value in [output formats](/v1-api/apidocs/output-formats) which provide data as key-value paired JSON objects. Defaults to the value of id. |
| name | string | Optional. Custom field name. Appears in the response field_name property and in the header row of the query results. Not allowed to contain any HTML. |
| split | string | Optional. Field split by type. Defaults to row. **row** \| Field value will be placed into rows **column** \| Field value will be used as a column (pivoting) |
| transform | string | Optional. Transformations to apply to this field. See [transformations](/v1-api/apidocs/transformation-filters) for more. |
| visible | bool | Optional. Whether field should be visible in query results. Field data is still queried and used e.g. to split rows, but just not returned in final query results. See related setting [no_dimensions](/v1-api/apidocs/settings#general-settings). Defaults to true. |