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

# system.groups.loadFromFile

> Loads a transaction group configuration from an xml export, into the specified project.

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.

## Client Permission Restrictions
This scripting function has no [Client Permission](projects\project-properties\project-properties.md#client---permissions) 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

## Code Examples
```python title="Example #1"
# 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)
```