# Api_WidgetCustomization

Type: object

Schema: [Api_WidgetCustomization](https://sourcey-azuracast.pages.dev/docs/api/models/api-widgetcustomization/index.md)

- `primaryColor` (optional)
  Type: string; nullable
  
  Primary accent color (hex without #).
  
  Example:
  
  ```json
  "2196F3"
  ```

- `backgroundColor` (optional)
  Type: string; nullable
  
  Background color (hex without #).
  
  Example:
  
  ```json
  "ffffff"
  ```

- `textColor` (optional)
  Type: string; nullable
  
  Text color (hex without #).
  
  Example:
  
  ```json
  "000000"
  ```

- `showAlbumArt` (optional)
  Type: boolean
  
  Whether album art should be shown.
  
  Example:
  
  ```json
  true
  ```

- `roundedCorners` (optional)
  Type: boolean
  
  Whether the widget should use rounded corners.
  
  Example:
  
  ```json
  false
  ```

- `autoplay` (optional)
  Type: boolean
  
  Whether autoplay should be requested.
  
  Example:
  
  ```json
  false
  ```

- `showVolumeControls` (optional)
  Type: boolean
  
  Whether the volume controls are visible.
  
  Example:
  
  ```json
  true
  ```

- `showTrackProgress` (optional)
  Type: boolean
  
  Whether track progress is visible.
  
  Example:
  
  ```json
  true
  ```

- `showStreamSelection` (optional)
  Type: boolean
  
  Whether stream selection controls are visible.
  
  Example:
  
  ```json
  true
  ```

- `showHistoryButton` (optional)
  Type: boolean
  
  Whether the history button is visible.
  
  Example:
  
  ```json
  false
  ```

- `showRequestButton` (optional)
  Type: boolean
  
  Whether the request button is visible.
  
  Example:
  
  ```json
  false
  ```

- `showPlaylistButton` (optional)
  Type: boolean
  
  Whether the playlist download button is visible.
  
  Example:
  
  ```json
  false
  ```

- `initialVolume` (optional)
  Type: integer
  
  Initial player volume (0-100).
  
  minimum: 0
  
  maximum: 100
  
  Example:
  
  ```json
  75
  ```

- `layout` (optional)
  Type: string
  
  Layout variant for the widget.
  
  Example:
  
  ```json
  "horizontal"
  ```

- `enablePopupPlayer` (optional)
  Type: boolean
  
  Whether to show an "open popup" button.
  
  Example:
  
  ```json
  false
  ```

- `continuousPlay` (optional)
  Type: boolean
  
  Whether to persist playback state across pages.
  
  Example:
  
  ```json
  false
  ```

- `customCss` (optional)
  Type: string; nullable
  
  Additional CSS applied to the widget.
  
  Example:
  
  ```json
  ".radio-player-widget { border-radius: 12px; }"
  ```