---
title: "system.tag.loadFromFile"
description: "This function locates an exported tag file and loads the tags into the specified tag provider."
---

# system.tag.loadFromFile

> This function locates an exported tag file and loads the tags into the specified tag provider.

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

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

## Description
## Client Permission Restrictions
[Permission Type](versioned_docs/version-8.1\ignition-modules\vision\vision-project-properties\vision-project-properties.md#vision-permissions-properties): Tag Editing

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

## Syntax
` system.tag.loadFromFile(filePath, provider, mode)`

- Parameters
    - String `filePath` - The path of the tag file to import from.
    - String `provider` - The name of the provider to import to.
    - Integer `mode` - Dictates what happens if the tag already exists. 0 = overwrite, 1 = ignore. 
- Returns
    - Nothing
- Scope
    - All

## Code Examples
```python title="Example #1"
# The following example loads a file named 'tags.xml' located at C:\
# The backslash character is an escape character in python, so we have to use it twice for the filePath variable
 
 
# Create variables to pass into the function
filePath = 'C:\\tags.xml'
provider = 'default'
 
 
# Load the file
system.tag.loadFromFile(filePath,provider,0)
```