Mastodon Profile Header Image Dimensions: How to Avoid Crop

When you upload a header image to your Mastodon profile, the platform automatically crops it to fit a specific aspect ratio. Many users find their carefully composed image looks wrong after upload — the top or bottom gets cut off, or the image appears too zoomed in. This happens because Mastodon uses a fixed 3:1 aspect ratio for header images, not the original dimensions of your file. This article explains the exact pixel dimensions you need, shows you how to prepare your image correctly, and lists common mistakes that cause unwanted cropping.

Why Mastodon Crops Header Images and What Aspect Ratio It Uses

Mastodon displays profile header images at a fixed 3:1 aspect ratio across all official and most third-party apps. This means the width of the displayed image is always three times its height. If you upload an image with a different ratio — for example, a standard 16:9 photo or a 4:3 square — Mastodon scales and crops the image to fit the 3:1 box. The cropping happens by default; you cannot control which part of the image survives the crop.

The platform does not resize the image file. It keeps the original file on the server but uses CSS to clip the visible area. This approach means the full image is still available in the page source, but visitors only see the center portion that matches the 3:1 ratio. The crop always starts from the center of the image, so important content at the edges or corners is lost.

The recommended pixel dimensions for a Mastodon header image are 1500 pixels wide by 500 pixels tall. These dimensions produce exactly a 3:1 ratio. Images larger than 1500 x 500 pixels are scaled down to fit, but the aspect ratio remains locked. Uploading an image smaller than 1500 x 500 pixels causes Mastodon to stretch it, resulting in a blurry or pixelated header.

The maximum file size for a header image is 2 MB. Mastodon accepts JPEG, PNG, and GIF formats. GIF headers animate on the web interface but are static in most mobile apps. WebP format is not supported for header images.

Steps to Prepare and Upload a Mastodon Header Image Without Cropping

Follow these steps to create a header image that fits the 3:1 box exactly. You will need an image editing application such as GIMP, Photoshop, or an online tool like Canva or Pixlr.

1. Open your image in an editor
   Launch GIMP, Photoshop, or Canva. Open the image file you want to use for your Mastodon header.
2. Set the canvas to 1500 x 500 pixels
   Create a new blank canvas with width 1500 pixels and height 500 pixels. This canvas acts as the final output frame.
3. Place your original image on the canvas
   Copy your original image and paste it onto the 1500 x 500 canvas as a new layer. Use the Move tool to adjust the position so the most important content is visible within the frame. The canvas shows exactly what Mastodon will display.
4. Scale the image layer if needed
   If your original image is larger than 1500 x 500 pixels, scale it down to fit. Hold the Shift key while dragging a corner handle to maintain proportions. If the image is smaller, do not scale it up — it will appear blurry. Instead, choose a higher-resolution source image.
5. Export the final image
   Export the combined canvas as a JPEG or PNG file. Set the quality to 90% or higher to avoid compression artifacts. Keep the file size under 2 MB.
6. Upload the header in Mastodon
   Sign in to your Mastodon account on the web interface. Go to Preferences > Profile > Edit profile. Click the Header area. Select your prepared image file from your computer. Click Save changes at the bottom of the page.
7. Verify the result
   Open your profile page in a browser. The header should display exactly as you framed it, with no cropping or stretching. Test on a mobile device as well — some apps may show a slightly different crop. If the image still looks wrong, repeat the process with tighter framing on the 1500 x 500 canvas.

Common Mistakes That Cause Mastodon Header Image Cropping

Uploading a 16:9 or 4:3 Image Without Resizing

The most frequent mistake is uploading a photo taken with a phone or camera. These images have a 16:9 or 4:3 aspect ratio. Mastodon crops them to 3:1, which removes roughly two-thirds of the image height. The center of the photo survives, but the top and bottom are lost. Always crop your image to 3:1 before uploading.

Using an Image Smaller Than 1500 x 500 Pixels

Uploading a 600 x 200 pixel image causes Mastodon to stretch it to fill the header area. The result is a blurry, pixelated header that looks unprofessional. Do not rely on Mastodon to upscale your image. Prepare the image at exactly 1500 x 500 pixels for the best quality.

Ignoring the Safe Zone for Text and Logos

Mastodon overlays your display name, bio, and avatar on top of the header image. These elements appear in the lower-left area of the header on desktop and in the center on mobile. If you place text or a logo in that area, it becomes unreadable behind the overlay. Keep important content in the upper two-thirds of the 1500 x 500 canvas, away from the bottom-left corner.

Not Testing on Multiple Devices

The Mastodon web interface and mobile apps may display the header differently. Some apps use a slightly taller or shorter crop. Test your header on at least two devices — one desktop browser and one mobile app — to confirm the framing works everywhere.

Item	Recommended Dimensions	Common Mistake
Header image pixel size	1500 x 500 pixels	Using 1920 x 1080 or 1200 x 400
Aspect ratio	3:1	Uploading 16:9 or 4:3 images
File format	JPEG or PNG	Using WebP or BMP
File size limit	Under 2 MB	Uploading a 5 MB file and getting an error
Safe zone for text	Upper two-thirds of the image	Placing text in the bottom-left corner

You can now prepare a Mastodon header image that displays exactly as you intended, without unexpected cropping or blurriness. Start by creating a 1500 x 500 pixel canvas in your image editor and positioning your content within that frame. For future header updates, save a template file with the correct dimensions so you can reuse the layout. One advanced tip: use a 1500 x 600 pixel canvas and add a 50-pixel transparent padding on the top and bottom — this gives you a buffer if a future Mastodon update changes the crop area.