When you upload a header or avatar image to your Mastodon profile, the platform automatically crops and resizes it to fit fixed display areas. This cropping can cut off important parts of your image if you do not prepare the file at the correct aspect ratio. Many users discover the cropping only after saving the image, when faces, text, or logos disappear from the visible frame. This article explains exactly how Mastodon handles image aspect ratios for profile headers and avatars, what dimensions the platform expects, and how to avoid unwanted cropping before you upload.
Key Takeaways: Mastodon Profile Image Aspect Ratio Rules
- Header image 1500 x 500 pixels: A 3:1 aspect ratio that crops the top and bottom of wider images.
- Avatar image 400 x 400 pixels: A 1:1 square crop from the center of any non-square upload.
- Upload button in Preferences > Profile: Opens the file picker; no preview of the crop zone is shown before save.
How Mastodon Crops Profile Images
Mastodon applies a center crop to both header and avatar images. The platform does not stretch or distort images. Instead, it scales the image down so that the shorter dimension matches the target display size, then removes any excess from the longer dimension. The crop is always centered, meaning the outer edges of the image are removed equally from both sides.
For the header image, the target aspect ratio is 3:1, which corresponds to a display area of 1500 pixels wide by 500 pixels tall. If your uploaded image has a different aspect ratio, Mastodon will scale it until one dimension fits the target, then crop the other dimension from the center. For example, a 2000 x 1000 pixel image has a 2:1 ratio. Mastodon scales it down so the height matches 500 pixels, producing a 1000 x 500 image. The platform then crops the sides to reach 1500 pixels wide, removing 250 pixels from each side.
For the avatar image, the target is a perfect square of 400 x 400 pixels. Any non-square image is scaled so the shorter side reaches 400 pixels, then the longer side is cropped equally from both ends. A 600 x 400 portrait image, for instance, is scaled to 600 x 400 first, then 100 pixels are removed from the top and bottom to create a 400 x 400 square.
Why Aspect Ratio Matters for Branding
Business accounts often place logos, taglines, or product photos in profile images. If you position key visual elements near the edges of the image, the center crop will remove them. The header image is especially problematic because the 3:1 ratio is much wider than typical camera photos or graphics. Many users upload a 16:9 or 4:3 image and lose the top and bottom parts, which may contain a logo or a person’s face.
Preparing Images to Avoid Unwanted Cropping
To guarantee that your image appears exactly as intended, resize and crop it to the exact target dimensions before uploading. Use any image editor — Microsoft Paint, Photoshop, GIMP, or an online tool — to set the header to 1500 x 500 pixels and the avatar to 400 x 400 pixels. When you upload a file that already matches these dimensions, Mastodon applies no additional cropping.
If you cannot resize the image beforehand, place all critical content — text, faces, logos — in the center 60 percent of the image. For a header, keep content within the middle 900 pixels horizontally and the full 500 pixels vertically. For an avatar, keep content within the center 400 x 400 square, but avoid the outer 20 percent on each side as a safety margin.
- Open your image in an editor
Launch Microsoft Paint, Photoshop, or any tool that shows pixel dimensions. Verify the current width and height of your file. - Crop the header to 1500 x 500 pixels
Use the crop tool to set the selection to 1500 pixels wide and 500 pixels tall. Center the crop over the most important area of the image, then apply the crop. - Crop the avatar to 400 x 400 pixels
Use the crop tool to set a square selection of 400 x 400 pixels. Position the square so that your face, logo, or key graphic is centered, then apply the crop. - Save the file as PNG or JPEG
Use PNG for graphics with text or logos to avoid compression artifacts. Use JPEG for photographs. Keep the file size under 2 MB to ensure fast upload. - Upload to Mastodon
Go to Preferences > Profile. Click the header or avatar image area. Select your prepared file. The image will appear without additional cropping.
Common Mistakes When Uploading Profile Images
Header Image Loses Top and Bottom Content
This is the most frequent complaint. Users upload a standard 16:9 photo or a tall graphic, and Mastodon crops the top and bottom. The cause is always a mismatch between the uploaded image’s aspect ratio and the 3:1 target. The fix is to crop the image to 1500 x 500 before uploading, or to move all important content to the horizontal center band of the image.
Avatar Image Cuts Off Faces or Logos
When you upload a rectangular photo, Mastodon crops it to a square from the center. If your face or logo is positioned near the top or bottom edge of the original photo, it will be cut off. To avoid this, either crop the photo to a 400 x 400 square before uploading, or position the subject in the center of the frame when taking the photo.
Image Appears Blurry After Upload
Mastodon scales images down to fit the display dimensions. If you upload a very small image — for example, a 200 x 200 pixel avatar — the platform upscales it to 400 x 400 pixels, which causes blurriness. Always upload images at the exact target size or larger. Larger images are scaled down, which preserves sharpness better than upscaling.
Mastodon Header vs Avatar: Aspect Ratio and Display Comparison
| Item | Header Image | Avatar Image |
|---|---|---|
| Target display size | 1500 x 500 pixels | 400 x 400 pixels |
| Aspect ratio | 3:1 | 1:1 square |
| Cropping behavior | Center crop on the horizontal axis | Center crop on both axes |
| Safe zone for content | Middle 900 pixels horizontally | Middle 320 pixels in both directions |
| Recommended upload size | 1500 x 500 or larger with same ratio | 400 x 400 or larger with same ratio |
Mastodon does not display profile images in a lightbox or allow users to view the uncropped version. The crop is permanent for the web interface and all mobile apps. By preparing your images to the exact dimensions listed above, you maintain full control over how your profile looks to other users. After uploading, verify the result by viewing your own profile page and checking that no important visual elements are missing.