---
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 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
Vision Client

## 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
```