---
title: "File Write Adaptor"
slug: "file-write-adaptor"
updated: 2024-09-03T13:30:58Z
published: 2024-09-03T13:30:58Z
canonical: "help.csgi.com/file-write-adaptor"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.csgi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# File Write Adaptor

## Creating a File Write Adaptor

In order to use a **File Write Adaptor**, it is best practice to create a [file connection](/v1/docs/file-connection) first.

The File Write Adaptor writes contents from a graph to an object-based file.

![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/File%20write(1).png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A17%3A54Z&se=2026-10-26T15%3A17%3A54Z&sr=c&sp=r&sig=mAfcbkKFRph0omnD3IHmHQOct6zj6Nj4w51SbFXArfQ%3D)

![:closed_lock_with_key:](https://pf-emoji-service--cdn.us-east-1.prod.public.atl-paas.net/standard/caa27a19-fc09-4452-b2b4-a301552fd69c/32x32/1f510.png)

Currently, only Amazon Web Services Simple Storage System (AWS S3) is supported, but it is planned to expand to other types (for example, Azure blob storage)

- **AWS S3** is an object-based storage scheme that presents a file-system view of the objects that it stores; folders are termed **buckets,** and files are **objects**. For all intents and purposes, it appears like a web-hosted file system. The ability to read and write data from S3 buckets helps integrate with other systems that can only handle file-based integrations, such as DMPs.
- To create a new item via the Create menu option in the project editor, select the **File adaptor**, and give the adaptor a name.
- Choose the connection from the dropdown menu, and choose the file name and file contents destination.
- **File Nam****e**: The File Name value can be provided by a literal, schema value, or public variables

- For S3, this name should include any path outside of the top-level bucket.
- A [JavaScript Node](/v1/docs/javascript-node) can be used to generate a file name that uses a timestamp and a unique identifier to ensure that files are ordered by creation date and also that there is no clash or accidental overwriting if multiple engines are processing and writing files simultaneously.

**File Contents To Write:** The contents to write to the file, which could be any part of schema value (recommended) or a public variable

- The file is created on each write and will overwrite any existing file without creating an error. It is, therefore, suggested that a unique identifier is used to generate the filename.
- For S3, buckets often contain many thousands of small objects rather than one large file - most third-party data loading processes are happy to process a large number of small files.

---

## Validation Warnings

: Al![](https://cdn.document360.io/c578bb14-e570-4b6e-93ed-f6c5b8a2d8a1/Images/Documentation/Inavalis(2).png?sv=2026-02-06&spr=https&st=2026-10-26T14%3A17%3A54Z&se=2026-10-26T15%3A17%3A54Z&sr=c&sp=r&sig=mAfcbkKFRph0omnD3IHmHQOct6zj6Nj4w51SbFXArfQ%3D)l the invalid notifications will be displayed after expanding the **Invalid Dropdown**.

| Warning | Note |
| --- | --- |
| Adaptor(s) do not have connection set | Creating a connection and choosing it from the Adaptor Connection dropdown is necessary. |
| Adaptor's configuration requires a data source to be set | No source for the file write (File Contents To Write) has been specified |
| File adaptors need a file name | No file name was provided for the file to write |

---

### Related Pages:

- [File Read Adaptor](/v1/docs/file-read-adaptor)