File and media management | Civio CMS Knowledge Base [ ![Civio Knowledge Base](/storage/branding/01KP4QF0THM695BDF2MG6TX3CY.svg) ](https://nginx.deploy-lagoon-production.districtcms-docs.dh1.amazee.io) [Articles](/articles) [Releases](/releases) [Home](/) [Knowledge base](/articles) [Media management](/articles?category=10) File and media management ========================= Updated 3 weeks ago Search Go Overview -------- District provides a central media library where you can manage all your site's files, images, videos, documents, and more. This article covers supported file types, how Media Directories work, and how to upload, tag, and manage your media. Supported file types -------------------- District supports the following media types: - Audio - File - Image - Remote Video - Video Images uploaded to the media library are automatically optimised to reduce file size without visible quality loss. This applies to JPEG, PNG, and GIF formats and happens automatically — no action is needed from content editors. > **💡 Note:** Supported file types may vary by site. Refer to your user guide documentation for the full list available on your site. Media Directories ----------------- Media Directories expands the core media library by providing a hierarchical tree-view structure for organising your files. Key features include: - **Hierarchical structure:** Media files are organised in a tree of folders and subfolders. Directories appear in the left column; files (images, documents, etc.) appear in the right column. - **Media preview:** Selecting a media file shows a preview for quick inspection without leaving the tree view. - **Search functionality:** Search for specific media items within directories — particularly useful for large collections. Creating directories -------------------- Directories let you categorise and organise your media in a hierarchical structure using descriptive folder names. 1. Navigate to a section of the site that includes a media upload field to open the media dialog (e.g., the Media field in the Media site component) by accessing the Drupal administration dashboard.. 2. In the media dialog, right-click on the **Root** directory and select **New folder**. A new folder will be created under Root. > **💡 Note:** You can also rename, delete, or create subdirectories by right-clicking on any existing folder. ![](/storage/9I1d7AZRRAaMqudvqAhXy8GkcGtIzlxTtaHwgo3K.png) Adding and tagging media ------------------------ When adding media to content, you can assign it to a directory to keep your library organised. 1. In the content editing form, locate and click the **Select media** button in the media field. 2. In the entity browser that opens, click **Add media** to upload a new file. 3. Choose the media type to upload (e.g. Image, Remote Video). Permitted file extensions are listed next to the field. 4. On the Add Media screen, select the **directory** to assign the file to from the dropdown. The dropdown also supports autocomplete. 5. Fill in any required fields and click **Save and select**. 6. You'll be returned to the entity browser with the uploaded file selected. Click **Select media** to insert it into the content field. Tagging existing media ---------------------- Existing media items can be edited to assign them to a directory. 1. In the administration menu, go to **Content > Media**. 2. Locate the media item you want to update and click **Edit**. 3. Under the **Directory** label, select the appropriate directory from the dropdown. The dropdown supports autocomplete. 4. Click **Save**. The media item will now appear in the selected directory. Managing existing media ----------------------- From the media library you can also edit, delete, and search your files: - **Editing:** Click on a file to view its details. You can update the name, alternative text, and other fields. - **Deleting:** Select one or more files and use the **Delete** action. This cannot be undone. - **Searching and filtering:** Use the search bar and filters to find files by name, type, or date. Replace and delete files ------------------------ You can replace an existing file in the media library while keeping the same filename and URL. This means any content that already links to or displays that file will continue to work without needing to be updated. To replace a file: 1. In the administration menu, go to **Content > Media**. 2. Locate the file you want to replace and click **Edit**. 3. In the file field, remove the existing file and upload the new version. 4. Click **Save**. You can also permanently delete files from the file system when they are no longer needed. > **⚠️ Warning:** Deleting a file is permanent and cannot be undone. Make sure the file is no longer in use before deleting it. To delete a file: 1. In the administration menu, go to **Content > Media**. 2. Select the file or files you want to delete using the checkboxes. 3. Choose **Delete media** from the **Action** dropdown and click **Apply to selected items**. 4. Confirm the deletion. --- Related articles ---------------- - **Using the WYSIWYG editor** — How to insert media into content using the editor toolbar - **Site components overview** — The Media component for embedding media in page layouts [ Back to articles ](/articles) Table of contents ----------------- © 2026 [District](https://www.district.au)