diff --git a/editor/media.mdx b/editor/media.mdx index d3a18bb81..e9fb19a16 100644 --- a/editor/media.mdx +++ b/editor/media.mdx @@ -1,14 +1,14 @@ --- title: "Add media" -description: "Upload, organize, and use images and assets in your documentation." +description: "Upload and manage images and assets in your documentation." keywords: ["editor", "media", "images", "assets"] --- -Use the media manager to upload and organize images and other assets in your documentation. +Use the media manager to upload and manage images and other assets in your documentation. ## Access the media manager -Access the media manager from the bottom of the left panel in the editor. +Access the media manager by clicking **Assets** at the bottom of the left panel in the editor. Media manager in the sidebar in light mode @@ -17,7 +17,7 @@ Access the media manager from the bottom of the left panel in the editor. ## Upload assets -To upload files, drag them into the media manager or click the **Add** button to select files from your computer. +To upload files, click the **Upload** button and select files from your computer. **Supported file types:** @@ -26,23 +26,19 @@ To upload files, drag them into the media manager or click the **Add** button to - **Fonts**: TTF, WOFF, WOFF2 - **Other**: PDF, ICO (favicons) -## Organize assets +## Manage assets -Use folders to group related images, separate light and dark mode assets, or organize by feature area. +### Configure assets -To create a new folder, click **Add**. +To configure an asset, right-click on it or click the **...** button and select **Configure**. You can rename the file and view its size. -### Move assets +### Copy asset path -Drag and drop assets to move them between folders. File paths update automatically when you move assets. - -### Rename assets - -To rename an asset, click the **...** button beside the asset name and then click **Rename**. References to renamed assets update automatically. +To copy an asset's path, right-click on it or click the **...** button and select **Copy path**. ### Delete assets -To delete an asset, click the **...** button beside the asset name and then click **Delete**. +To delete an asset, right-click on it or click the **...** button and select **Delete**. ## Use media in documentation @@ -62,5 +58,4 @@ To delete an asset, click the **...** button beside the asset name and then clic - **Use descriptive names**: Name files clearly. For example, `api-dashboard-light.png` instead of `img1.png`. - **Add alt text**: Always provide descriptive alt text for accessibility and SEO. -- **Organize folders**: Group related assets in folders for easier management. - **Use appropriate formats**: PNG for graphics with transparency, JPG for photos, SVG for icons and logos.