---
title: "system.tag.write"
description: "Writes a value to a tag."
---

# system.tag.write

> Writes a value to a tag.

:::note Deprecated
This function was deprecated in 8.1.0.
:::

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

## Description
Writes a value to a tag. Note that this function writes asynchronously. This means that the function does not wait for the write to occur before returning - the write occurs sometime later on a different thread.

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

## Syntax
`system.tag.write(tagPath, value, suppressErrors)`

- Parameters
    - String `tagPath` - The path of the tag to write to.
    - Object `value` - The value to write.
    - Boolean `suppressErrors` - A flag indicating whether or not to suppress errors. (optional, client-only).
- Returns
    - int - 0 if the write failed immediately, 1 if it succeeded immediately, and 2 if it is pending.
- Scope
    - All

## Code Examples
```python title="Example #1"
# This code would go on a property change event for a numeric text field to calculate and write a value to a tag.
  
if event.propertyName == intValue:
    calcValue = event.newValue * 2.5
    system.tag.write("Tanks/tankHiSP",calcValue)
```