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

# List Report Fields

> Search and browse available Google Analytics (GA4) reporting metrics and dimensions before running reports

Search and browse available Google Analytics (GA4) reporting metrics and dimensions before running reports. For complete field discovery, first call ga4\_select\_accounts, then provide both connection\_id and one selected account/property to include property-specific custom metrics, custom dimensions, and key-event fields. Omit both only when the generic static GA4 field catalog is sufficient. Use filters to search fields by name or ID e.g \[\{'field':'id','operator':'REGEXP\_MATCH','value':'.*(sessions|pageviews).*'}].

|                      |                          |
| -------------------- | ------------------------ |
| **App**              | Google Analytics         |
| **Operation ID**     | `ga4_list_report_fields` |
| **Type**             | Action                   |
| **Connection**       | None                     |
| **Credits per run**  | Free                     |
| **Agent / MCP tool** | Yes                      |

## Inputs

| Field        | Type                                          | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------------ | --------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `field_type` | string or SelectableOption                    | No       | `all`   | Filter by field type: 'all', 'dimension', or 'metric'. Default is 'all'.                                                                                                                                                                                                                                                                                                                                                                          |
| `filters`    | array of FilterItem                           | No       | -       | Use this to search fields by name or ID. Each filter must have a field, operator, and value. Available fields to filter by are: - 'id': The field ID  \[\{"field":"id","operator":"REGEXP\_MATCH","value":".*(session\|user).*"}] - 'name': The field name \[\{"field":"name","operator":"CONTAINS","value":"session"}] Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP\_MATCH or IN\_LIST. |
| `limit`      | integer                                       | No       | -       | The maximum number of fields to return. Set it to avoid too many results.                                                                                                                                                                                                                                                                                                                                                                         |
| `account`    | array (also accepts a comma-separated string) | No       | -       | Strongly recommended for complete field discovery. Call ga4\_select\_accounts first, then provide exactly one selected GA4 property together with connection\_id. This includes the property's custom metrics, custom dimensions, and key-event fields. Omit both account and connection\_id only when the generic static GA4 field catalog is sufficient.                                                                                        |

### FilterItem

| Field      | Type                       | Required | Default | Description                                                                                                                                                                             |
| ---------- | -------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `field`    | string or SelectableOption | Yes      | -       | The field to filter on, must be one of the current selected metrics or dimensions.                                                                                                      |
| `operator` | string                     | Yes      | -       | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*'                           |
| `value`    | string                     | Yes      | -       | The value to filter by, always as a string: text, a number, or a regex. For IN\_LIST and NOT\_IN\_LIST, pass the values as one comma-separated string such as 'a,b,c', not as an array. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `List[Dict]`

Returns list of available report fields.

**Fields**: `id`, `name`, `type`, `data_type`