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

# IDashboardWidgetCustomizer

- Package: [@gooddata/sdk-ui-dashboard](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/index.md)
- Kind: interface
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-ui-dashboard/src/plugins/customizer.ts
- Guides: [Customize widgets and visualizations](https://www.gooddata.ai/docs/gooddata-ui/latest/dashboard-plugins/customize-widgets/index.md)

Set of functions you can use to customize custom widgets.

**Signature:**

```typescript
export interface IDashboardWidgetCustomizer 
```

## Methods

| Method | Description |
| --- | --- |
| [addCustomWidget(widgetType, Component)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardwidgetcustomizer/index.md#idashboardwidgetcustomizeraddcustomwidget) | Adds a new custom widget type. |

## Method details

### IDashboardWidgetCustomizer.addCustomWidget()

Adds a new custom widget type.

**Signature:**

```typescript
addCustomWidget(widgetType: string, Component: CustomDashboardWidgetComponent): IDashboardWidgetCustomizer;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| widgetType | string | unique type name of the custom widget; if plugins register multiple custom widgets for the same widget type, then the last-registered custom widget wins |
| Component | [CustomDashboardWidgetComponent](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.customdashboardwidgetcomponent/index.md) | React component to use for rendering of the custom widget |

**Returns:**

[IDashboardWidgetCustomizer](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-ui-dashboard/sdk-ui-dashboard.idashboardwidgetcustomizer/index.md)

#### Remarks

Custom widget's can be used to render arbitrary content.

The custom widget must be wrapped inside an element which sets the height and width CSS sizing properties in order to align the behavior with the provided widget types.
