> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IInsightLayerDefinition

- Package: [@gooddata/sdk-model](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/index.md)
- Kind: interface
- Stability: alpha
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-model/src/insight/index.ts

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Defines a single layer in a multi-layer visualization (e.g., geo charts).

**Signature:**

```typescript
export interface IInsightLayerDefinition 
```

## Remarks

Each layer has its own buckets, filters, sorts, and properties, allowing independent data configuration per layer.

## Properties

| Property | Modifiers | Type | Description |
| --- | --- | --- | --- |
| [attributeFilterConfigs?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightlayerdefinition/index.md#iinsightlayerdefinitionattributefilterconfigs) |  | [IAttributeFilterConfigs](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iattributefilterconfigs/index.md) | **_(ALPHA)_** _(Optional)_ Attribute filter configurations for this layer |
| [buckets](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightlayerdefinition/index.md#iinsightlayerdefinitionbuckets) |  | [IBucket](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ibucket/index.md)[] | **_(ALPHA)_** Buckets containing attributes/measures for this layer |
| [filters?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightlayerdefinition/index.md#iinsightlayerdefinitionfilters) |  | [IFilter](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.ifilter/index.md)[] | **_(ALPHA)_** _(Optional)_ Filters specific to this layer |
| [id](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightlayerdefinition/index.md#iinsightlayerdefinitionid) |  | string | **_(ALPHA)_** Unique identifier for this layer |
| [name?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightlayerdefinition/index.md#iinsightlayerdefinitionname) |  | string | **_(ALPHA)_** _(Optional)_ Optional human-readable name for the layer |
| [properties?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightlayerdefinition/index.md#iinsightlayerdefinitionproperties) |  | [VisualizationProperties](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.visualizationproperties/index.md) | **_(ALPHA)_** _(Optional)_ Layer-specific visualization properties |
| [sorts?](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightlayerdefinition/index.md#iinsightlayerdefinitionsorts) |  | [ISortItem](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.isortitem/index.md)[] | **_(ALPHA)_** _(Optional)_ Sorting configuration for this layer |
| [type](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.iinsightlayerdefinition/index.md#iinsightlayerdefinitiontype) |  | string | **_(ALPHA)_** Layer visualization type (e.g., "pushpin", "area") |

## Property details

### IInsightLayerDefinition.attributeFilterConfigs

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Attribute filter configurations for this layer

**Signature:**

```typescript
attributeFilterConfigs?: IAttributeFilterConfigs;
```

#### Remarks

If not set, the layer will inherit the attribute filter configs from the root insight definition.

### IInsightLayerDefinition.buckets

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Buckets containing attributes/measures for this layer

**Signature:**

```typescript
buckets: IBucket[];
```

### IInsightLayerDefinition.filters

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Filters specific to this layer

**Signature:**

```typescript
filters?: IFilter[];
```

#### Remarks

If not set, the layer will inherit the filters from the root insight definition.

### IInsightLayerDefinition.id

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Unique identifier for this layer

**Signature:**

```typescript
id: string;
```

### IInsightLayerDefinition.name

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Optional human-readable name for the layer

**Signature:**

```typescript
name?: string;
```

### IInsightLayerDefinition.properties

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Layer-specific visualization properties

**Signature:**

```typescript
properties?: VisualizationProperties;
```

#### Remarks

If not set, the layer will inherit the properties from the root insight definition.

### IInsightLayerDefinition.sorts

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Sorting configuration for this layer

**Signature:**

```typescript
sorts?: ISortItem[];
```

#### Remarks

If not set, the layer will inherit the sorting from the root insight definition.

### IInsightLayerDefinition.type

> **Alpha API.** Initial API, highly likely to change outside SemVer. Don't build on it in production. See [API maturity](https://www.gooddata.ai/docs/gooddata-ui/latest/integrations/platform/api-maturity/index.md).
> 

Layer visualization type (e.g., "pushpin", "area")

**Signature:**

```typescript
type: string;
```

#### Remarks

This determines how the layer data should be visualized. For geo charts: "pushpin" for point-based layers, "area" for polygon-based layers.