---
title: "system.groups.loadFromFile"
description: "Loads a transaction group configuration from an xml export, into the specified project (creating the project if necessary)."
---

# system.groups.loadFromFile

> Loads a transaction group configuration from an xml export, into the specified project (creating the project if necessary).

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

## Description
Loads a transaction group configuration from an xml export, into the specified project (creating the project if necessary). The mode parameter dictates how overwrites occur.

:::note
This function is scoped for Perspective Sessions, but since all scripts in Perspective run on the Gateway, the file must be located on the Gateway's file system. 
:::

## 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.groups.loadFromFile(filePath, projectName, mode)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `filePath` | The path to a valid transaction group xml or csv file.
String| `projectName` | The name of the project to load into.
int| `mode` | How duplicates will be handled. 0 = Overwrite, 1 = Ignore, 2 = Replace the existing project with this one.

### Returns
Nothing
### Scope
Gateway, Perspective Session

## Code Examples
```python title="Example #1 - Loading a Transaction Group Into a Project"
# Note that backslashes are used in Windows filepaths, but are also escaped in Python. Thus, we use the double-backslashes here.
path = "C:\\Users\\user\\Desktop\\group.xml"
 
projName = "MyProject"
 
# Read a Transaction Group from a file and overwrite any preexisting groups that match those in our file.
system.groups.loadFromFile(path, projName, 0)
```