From 158e8f27161bf668587f869cd1f94b8cbcb0277e Mon Sep 17 00:00:00 2001 From: Daniel Lautzenheiser Date: Wed, 12 Apr 2023 16:38:38 -0400 Subject: [PATCH] docs: add documentation for media library folders feature --- packages/docs/content/docs/beta-features.mdx | 6 ++++++ .../docs/content/docs/configuration-options.mdx | 17 ++++++++++++++++- 2 files changed, 22 insertions(+), 1 deletion(-) diff --git a/packages/docs/content/docs/beta-features.mdx b/packages/docs/content/docs/beta-features.mdx index 6fa99ebc..fd2c3440 100644 --- a/packages/docs/content/docs/beta-features.mdx +++ b/packages/docs/content/docs/beta-features.mdx @@ -192,6 +192,12 @@ For repositories stored on Gitea, the gitea backend allows CMS users to log in d See [Gitea Backend](/docs/gitea-backend) for more information. +## Media Library Folders + +Adds support for viewing subfolders and creating new subfolders in the media library, under your configured `media_folder`. + +See [Media Library Folders](/docs/configuration-options#media-library-folders) for more information. + ## External Media Library Using an external media library allows you to store your media files outside of your git backend. This is helpful if you are trying to store large media files. There are three external media libraries available in beta: diff --git a/packages/docs/content/docs/configuration-options.mdx b/packages/docs/content/docs/configuration-options.mdx index c7b820aa..69ec8c74 100644 --- a/packages/docs/content/docs/configuration-options.mdx +++ b/packages/docs/content/docs/configuration-options.mdx @@ -67,7 +67,22 @@ Based on the settings above, if a user used an image widget field called `avatar This setting can be set to an absolute URL e.g. `https://netlify.com/media` should you wish, however in general this is not advisable as content should have relative paths to other content. -## Media Library +## Media Library Folders + +The `media_library_folder_support` flag enables support for viewing subfolders and creating new subfolders in the media library, under your configured `media_folder`. + + +```yaml +media_library_folder_support: true +``` + +```js +media_library_folder_support: true, +``` + + + +## Media Library Integrations Media library integrations are configured via the `media_library` property, and its value should be an object with at least a `name` property. A `config` property can also be used for options that should be passed to the library in use.