---
title: "system.gui.chooseColor"
description: "Prompts the user to pick a color using the default color-chooser dialog box."
---

# system.gui.chooseColor

> Prompts the user to pick a color using the default color-chooser dialog box.

This function is used in **Python Scripting**.

## Description
## Client Permission Restrictions
This scripting function has no [Client Permission](projects\project-properties\project-properties.md#client---permissions) restrictions.

## Syntax
`system.gui.chooseColor(initialColor [, dialogTitle])`

### Parameters

|Type|Parameter|Description|
|--|--|--|
|Color |`initialColor`| A color to use as a starting point in the color choosing popup.|
|String |`dialogTitle` | The title for the color choosing popup. Defaults to "Choose Color". [optional]|
### Returns
**Color** - The new color chosen by the user.
### Scope
All

## Code Examples
```python title="Example #1"
# This code would be placed in the actionPerformed event of a button, and would change the background color of the container the button was placed in.
  
parent = event.source.parent
newColor = system.gui.chooseColor(parent.background)
parent.background = newColor
```