Skip to content
Andesphere Docs

Managing Media in Strapi

The Media Library in Strapi is your central hub for managing all digital assets. This guide will help you understand how to effectively manage your media files.

Supported File Types

Strapi supports various file types including:

  • Images (JPG, PNG, GIF, WebP)
  • Documents (PDF, DOC, DOCX)
  • Videos (MP4, WebM)
  • Audio files (MP3, WAV)

Uploading Media

Method 1: Direct Upload

  1. Navigate to the Media Library

Strapi Media Library

  1. Click “Upload assets” or “Add new assets” or drag files into the upload area
  2. Select one or multiple files from your computer
  3. Wait for the upload to complete

Method 2: From Content Editor

  1. While editing content, click on the media field
  2. Choose “Browse files” or drag files directly
  3. Select existing media or upload new files
  4. Click “Add assets” to confirm

Organizing Media

Creating Folders

  1. Click “Create new folder” in the Media Library
  2. Name your folder appropriately
  3. Use folders to organize media by:
    • Content type
    • Date
    • Campaign
    • Project

Moving Files

  1. Select the files you want to move
  2. Click “Move to” in the top menu
  3. Select the destination folder
  4. Confirm the move

Best Practices for Images

Image Requirements

  • Formats: Prefer WebP for web images
  • Size: Keep files under 5MB when possible
  • Dimensions: Upload at the largest size needed
  • Names: Use descriptive, URL-friendly names

Image Optimization Tips

  1. Compress images before uploading
  2. Use appropriate image dimensions
  3. Consider loading time impact
  4. Add alt text for accessibility

Managing Media Assets

Editing Asset Information

  1. Click on an asset to open its details
  2. Edit the following:
    • Alternative text
    • Caption
    • File name
  3. Save your changes

Deleting Media

  1. Select the files to delete
  2. Click the delete button
  3. Confirm deletion ⚠️ Note: Deleting media is permanent

Media Usage Guidelines

File Naming Conventions

  • Use lowercase letters
  • Replace spaces with hyphens
  • Keep names descriptive but concise
  • Include relevant keywords

Organization Tips

  • Create a clear folder structure
  • Use consistent naming patterns
  • Regular cleanup of unused media
  • Document your organization system

Troubleshooting

Common issues and solutions:

  1. Upload Failed

    • Check file size limits
    • Verify file type is supported
    • Ensure stable internet connection

  2. File Not Showing

    • Clear browser cache
    • Check file permissions
    • Verify file format compatibility

  3. Slow Media Library

    • Optimize large files
    • Clean up unused assets
    • Check internet connection

Need Help?

If you encounter issues with media management:

  1. Check this documentation first
  2. Contact Andesphere support for assistance
  3. Consider joining our community forums