Skip to content

Media Management

The Media tab in Sanity Studio provides a centralized location to manage all your images and media files. This interface helps you organize, upload, and reuse media across your website.

Accessing Media Library

  1. Click on “Media” in the top navigation bar
  2. This opens the media management interface where you can:
    • View all uploaded media
    • Search for specific files
    • Upload new media
    • Organize your assets

Uploading Media

  1. Click the “Upload” button
  2. Select files from your computer
  3. Wait for the upload to complete
  4. Your media is now available for use across the site

Media Organization

Your media library supports:

  • Searching by filename
  • Filtering by type
  • Sorting by date
  • Basic file organization

Using Media in Content

To use uploaded media in your content:

  1. Open any content section that accepts images
  2. Click the image field
  3. Select “Browse” to access your media library
  4. Choose your desired image
  5. The selected image will be inserted into your content

Image Requirements

For optimal performance:

  • Recommended formats: JPG, PNG, WebP
  • Maximum file size: 10MB
  • Optimal dimensions:
    • Hero images: 1920px width
    • Gallery images: 800px width
    • Thumbnails: 400px width

Best Practices

  1. Name files descriptively:

    • Good: team-photo-2024.jpg
    • Avoid: IMG_12345.jpg
  2. Optimize before upload:

    • Compress images when possible
    • Use appropriate dimensions
    • Consider using WebP format for better performance
  3. Regular maintenance:

    • Remove unused media
    • Update outdated images
    • Keep file names consistent

Troubleshooting

Common issues and solutions:

  1. Upload failing:

    • Check file size
    • Verify file format
    • Ensure stable internet connection
  2. Image not displaying:

    • Confirm the publish status
    • Check the file path
    • Verify the image hasn’t been deleted
  3. Slow loading:

    • Optimize image size
    • Check image dimensions
    • Consider using a different format

Need additional help? Reach out to support or check the Sanity documentation for more detailed information about media handling.