---
title: "system.file.saveFile"
description: "Prompts the user to save a new file named filename."
---

# system.file.saveFile

> Prompts the user to save a new file named filename.

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

## Description
Prompts the user to save a new file named filename. The optional extension and typeDesc arguments will be used for a file type filter, if any. If the user accepts the save, the path to that file will be returned. If the user cancels the save, None will be returned.

## 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 #1
`system.file.saveFile(filename)`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `filename` | A file name to suggest to the user.

### Returns
**String** - The path to the file that the user decided to save to, or None if they canceled.

### Scope
Vision Client

## Syntax #2
`system.file.saveFile(filename, [extension], [typeDesc])`

### Parameters
Type | Parameter | Description 
------- | ------- | ------
String| `filename` | A file name to suggest to the user.
String| `extension` | The appropriate file extension, like "jpeg", for the file. [optional]
String| `typeDesc` | A description of the extension, like "JPEG Image". [optional]

### Returns
**String** - The path to the file that the user decided to save to, or None if they canceled.

### Scope
Vision Client    

## Code Examples
```python title="Example #1 - Saving a File (Text Area)"
# This code would prompt the user to save the text in a text area to a file.
  
path = system.file.saveFile("myfile.txt")
if path is not None:
   system.file.writeFile(path, event.source.parent.getComponent("Text Area").text)
```

```python title="Example #2 - Saving a File (Script Console)"
# This code prompts the user to save direct text in the system.file.writeFile()'s data parameter to a file.
 
path = system.file.saveFile("myfile.txt")
if path is not None:
  system.file.writeFile(path, "Hello World")
```