# Query$file

### Query$<mark style="color:purple;">file</mark>(*name, file\_id\_variable, file\_name\_variable*) → [**File**](https://docs.redivis.com/api/client-libraries/redivis-r/reference/file)

Reference a file within the query results. Only relevant for query results that contain at least one variable with file ids. If the query result contains multiple file id variables, must specify the `file_id_variable` parameter.

Same as calling `query$to_directory()$get(name)`.

### **Parameters:**

**`name` :&#x20;*****str***\
The full name of the file.

**`file_id_variable` :&#x20;*****str, optional***\
The name of the variable in the query results containing file ids. Only required if the query results contain more than one fileId variable.

**`file_name_variable` :&#x20;*****str, optional***\
The name of the variable in the query result containing the file name. If unspecified, will look for a variable `file_name` , or otherwise will use the file's original name.

### **Returns:**&#x20;

[**File**](https://docs.redivis.com/api/client-libraries/redivis-r/reference/file)