---
title: "system.util.setConnectionMode"
description: "Sets the connection mode for the client session."
---

# system.util.setConnectionMode

> Sets the connection mode for the client session.

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

## Description
Sets the connection mode for the client session. Normally a client runs in mode 3, which is read-write. You may wish to change this to mode 2, which is read-only, which will only allow reading and subscribing to tags, and running SELECT queries. Tag writes and INSERT/UPDATE/DELETE queries will not function. You can also set the connection mode to mode 1, which is disconnected, all tag and query features will not work.

## 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.util.setConnectionMode(mode)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
Integer | `mode` | The new connection mode. 1 = Disconnected, 2 = Read-only, 3 = Read/Write.

### Returns
Nothing

### Scope
Vision Client

## Code Examples
```python title="Example #1"
# This example, which could go in a project's startup script, would check the current username 
# and set the connection mode to read-only if it is the "guest" user.
  
username = system.security.getUsername()
if "guest" == username.lower():
   # Set "guest" user to read-only mode
   system.util.setConnectionMode(2)
else:
   system.util.setConnectionMode(3)
```