# File System Connector

A *File System Connector* is used to access the files in a folder on your web server or network. Consider for example the scenario where you might want to set up a working folder for your application, in the form of a secure folder on your server or network, from where files could be read or updated.

Do this:

1. Add a *File System Connector* to your application.
2. Provide your folder's path and, if required, provide it with valid user credentials to access the folder.
3. Once the connection is created, you can start reading, writing or deleting files from your 'workspace' by adding the relevant file function to a script or [Event](https://docs.stadium.software/features/events) handler. You can even assign image files directly to an Image control or allow users to download files to their local PC.

*Note:* The connector will have access to the specified folder and its sub-folders, but will have no access to any of the parent folders.

***

{% embed url="<https://www.youtube.com/embed/-0EX2JdsLVc?autoplay=1&rel=0&vq=1080>" %}
Add a File System Connector and a file function
{% endembed %}

***

### Connection Editor Properties

![](https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-bcd190d76806f19c95ae18fe547eee9b41fceace%2Ffilesystem-connection.png?alt=media)

1. **Path**

   This is the folder path on the server or network that will be made accessible via this connector.

   *Note:* Stadium currently supports [UNC paths](https://www.lifewire.com/unc-universal-naming-convention-818230), but not mapped drives yet.
2. **User**

   The username to gain access to the folder. This is in the format of \<domain name>\\\<username>.\
   If no value is provided for this property, the Application Pool User will be used.
3. **Password**

   The password that will be used in combination with the username to gain access to the folder.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stadium.software/connectors/file-system-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.