Windows Native Toolkit | File Picker Library

Use this library when you need a native Windows picker instead of a custom Unreal file browser.

Python examples use Unreal's reflected API names through the unreal module. Every input argument is passed explicitly to match Unreal Python binding expectations.

Open Path Picker

Opens one shared native picker for files or folders and always returns an array of selected paths.

Pin	Direction	Purpose
`DialogTitle`	Input	Window title shown by the picker.
`DefaultPath`	Input	Initial folder shown by the picker.
`FileTypes`	Input	Windows filter string. Used only when `PickerType` is `File`.
`bAllowMultiple`	Input	Allows selecting multiple files or folders.
`PickerType`	Input	Choose `File` or `Folder`.
`Return Value`	Output	True when the user confirmed a selection.
`OutPaths`	Output	Selected file or folder paths.

C++ Example

#include "FilePickerLibrary.h"

TArray<FString> PickedPaths;
const bool bPicked = UFilePickerLibrary::OpenPathPicker(
    TEXT("Select Files"),
    TEXT("C:/"),
    TEXT("Images|*.png;*.jpg"),
    true,
    EFilePickerType::File,
    PickedPaths
);

Python Example

import unreal

picked, picked_paths = unreal.FilePickerLibrary.open_path_picker(
    "Select Files",
    "C:/",
    "Images|*.png;*.jpg",
    True,
    unreal.FilePickerType.FILE,
)

Make File Filter

Builds a Windows file-dialog filter string from FFileDialogFilter entries.

Pin	Direction	Purpose
`Filters`	Input	Array of filter definitions.
`Return Value`	Output	Windows filter string suitable for `Open Path Picker` or `Open Save File Picker`.

Each FFileDialogFilter contains:

Name
Pattern

C++ Example

#include "FilePickerLibrary.h"

TArray<FFileDialogFilter> Filters;
FFileDialogFilter Images;
Images.Name = TEXT("Images");
Images.Pattern = TEXT("*.png;*.jpg");
Filters.Add(Images);

const FString FilterString = UFilePickerLibrary::MakeFileFilter(Filters);

Python Example

import unreal

filters = [
    unreal.FileDialogFilter(name="Images", pattern="*.png;*.jpg"),
]
filter_string = unreal.FilePickerLibrary.make_file_filter(filters)

Open Save File Picker

Opens the native Windows save dialog and returns the chosen output path.

Pin	Direction	Purpose
`DialogTitle`	Input	Window title shown by the save dialog.
`DefaultPath`	Input	Initial folder shown by the dialog.
`DefaultFileName`	Input	Initial file name shown in the dialog.
`FileTypes`	Input	Windows filter string.
`Return Value`	Output	True when the user confirmed a path.
`OutFilename`	Output	Full output file path selected by the user.

C++ Example

#include "FilePickerLibrary.h"

FString SavedPath;
const bool bSaved = UFilePickerLibrary::ShowSaveFilePicker(
    TEXT("Save Report"),
    TEXT("C:/Temp"),
    TEXT("Report.txt"),
    TEXT("Text Files|*.txt"),
    SavedPath
);

Python Example

import unreal

saved, saved_path = unreal.FilePickerLibrary.show_save_file_picker(
    "Save Report",
    "C:/Temp",
    "Report.txt",
    "Text Files|*.txt",
)

File Picker Library

Open Path Picker

Make File Filter

Open Save File Picker

On this page