---
title: "Adds a virtual folder."
method: POST
path: "/Library/VirtualFolders"
tags: ["LibraryStructure"]
---

# Adds a virtual folder.

`POST /Library/VirtualFolders`

## Query parameters

- `name` string, nullable — The name of the virtual folder.
- `collectionType` string, nullable — The type of the collection.
- `paths` string[], nullable — The paths of the virtual folder.
- `refreshLibrary` boolean — Whether to refresh the library.

## Request body

- AddVirtualFolderDto — Add virtual folder dto.
  - `LibraryOptions` LibraryOptions
    - `EnablePhotos` boolean
    - `EnableRealtimeMonitor` boolean
    - `EnableChapterImageExtraction` boolean
    - `ExtractChapterImagesDuringLibraryScan` boolean
    - `PathInfos` MediaPathInfo[], nullable
      - `Path` string, nullable
      - `NetworkPath` string, nullable
    - `SaveLocalMetadata` boolean
    - `EnableInternetProviders` boolean
    - `EnableAutomaticSeriesGrouping` boolean
    - `EnableEmbeddedTitles` boolean
    - `EnableEmbeddedEpisodeInfos` boolean
    - `AutomaticRefreshIntervalDays` integer
    - `PreferredMetadataLanguage` string, nullable — Gets or sets the preferred metadata language.
    - `MetadataCountryCode` string, nullable — Gets or sets the metadata country code.
    - `SeasonZeroDisplayName` string, nullable
    - `MetadataSavers` string[], nullable
    - `DisabledLocalMetadataReaders` string[], nullable
    - `LocalMetadataReaderOrder` string[], nullable
    - `DisabledSubtitleFetchers` string[], nullable
    - `SubtitleFetcherOrder` string[], nullable
    - `SkipSubtitlesIfEmbeddedSubtitlesPresent` boolean
    - `SkipSubtitlesIfAudioTrackMatches` boolean
    - `SubtitleDownloadLanguages` string[], nullable
    - `RequirePerfectSubtitleMatch` boolean
    - `SaveSubtitlesWithMedia` boolean
    - `TypeOptions` TypeOptions[], nullable
      - `Type` string, nullable
      - `MetadataFetchers` string[], nullable
      - `MetadataFetcherOrder` string[], nullable
      - `ImageFetchers` string[], nullable
      - `ImageFetcherOrder` string[], nullable
      - `ImageOptions` ImageOption[], nullable
        - `Type` 'Primary' | 'Art' | 'Backdrop' | 'Banner' | 'Logo' | 'Thumb' | 'Disc' | 'Box' | 'Screenshot' | 'Menu' | 'Chapter' | 'BoxRear' | 'Profile' — Enum ImageType.
        - `Limit` integer — Gets or sets the limit.
        - `MinWidth` integer — Gets or sets the minimum width.

## Response `204`

Folder added.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/jellyfin/apis/jellyfin-api.md) · [All operations](https://skmtc.net/jellyfin/apis/jellyfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jellyfin/jellyfin-api/versions/eb6f75af7066/schema)