Skip to main content

​
Upload methods

​
Method 1: Upload Media button

  1. Click on the Upload Media button in your Media Library.
Upload Media Button
  1. You can add one or multiple files at once from various sources:
    • My Device
    • URL
    • Image Search
    • Dropbox
    • Google Drive
    • Facebook
    • Instagram
    • Box
    • GitHub
Upload Sources

​
Method 2: Drag and drop

Simply drag and drop your files directly into media fields for quick uploads: Drag and Drop Images You can also drag and drop files directly into media fields within your content: Drag and Drop in Fields

​
Editing images during upload

Edit your images in the ButterCMS Media Library before saving them: Edit During Upload
You can crop, rotate, and apply a circle crop right during the upload process. After uploading, additional transformations like resizing, filters, and adjustments are available in the Image Editor.

​
Optimal file sizes

For optimal page speed and appearance, follow these guidelines:
ButterCMS automatically converts images to WebP format for better performance.
File TypeRecommended Size
Large/background imagesNo more than 1 MB
Standard images1200 pixels width or less

​
Best practices

  • Compress images before uploading using tools like TinyPNG or TinyJPG
  • Resize large images to 1200 pixels or less
  • Use appropriate formats — JPEG for photos, PNG for graphics with transparency
  • Let ButterCMS optimize — we automatically convert to WebP for better performance