---
title: "system.vision.showConfirm"
description: "Displays a confirmation dialog box to the user with Yes and No options, and a custom message."
---

# system.vision.showConfirm

> Displays a confirmation dialog box to the user with Yes and No options, and a custom message.

:::info Backwards Compatibility
This function replaces [system.gui.confirm](versioned_docs/version-8.1/appendix/scripting-functions/system-gui/system-gui-confirm.md). Any scripts containing Vision Client scoped functions that were replaced with system.vision syntax will still work to maintain backwards compatibility.
:::

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

## Description
Displays a confirmation dialog box to the user with **Yes** and **No** options, and a custom message.

:::note
This function is available on secondary desktops via the [system.vision.desktop](system-vision-desktop.md) function. See the [Multi-Monitor Clients](ignition-modules\vision\common-tasks-in-vision\multi-monitor-clients\multi-monitor-clients.md) page for more details on secondary desktops.
:::

## Client Permission Restrictions
This scripting function has no [Client Permission](../../../ignition-modules/vision/vision-project-properties/vision-project-properties.md#vision-permissions-properties) restrictions.

## Syntax
`system.vision.showConfirm(message, [title], [allowCancel])`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `message` | The message to show in the confirmation dialog.
String| `title` | The title for the confirmation dialog. [optional]
Boolean| `allowCancel` | Show a cancel button in the dialog. [optional]

### Returns
**Boolean** - True if the user selected **Yes**; false if the user selected **No**. None if the user selected **Cancel**.
    
### Scope
Vision Client

## Code Examples
```python title="Example #1"
# By using the confirm function in an if statement, we can let the user confirm an action. 
# In this case, we shut down the plant if the user confirms it; otherwise, we don't do anything.

if system.vision.showConfirm("Are you sure you want to shutdown the plant?", "Really Shutdown?"):
    system.db.runPrepUpdate(
        "UPDATE ControlTable SET Shutdown = ?",
        [1]
    )
```