A blurry BlueSky avatar or broken banner can make an otherwise solid profile look unfinished. The usual cause is not one magic setting. It is usually a mix of crop ratio, file size, stale cached images, and image metadata.
The safest workflow is to prepare the image before uploading: crop it intentionally, keep the file small, strip metadata, upload a fresh file, and verify the result on both desktop and mobile.
Review BlueSky's profile editing documentation for how avatar and banner images are uploaded as separate blobs.
Start with the right crop
Use a square image for the avatar. A practical working size is 400 by 400 pixels or larger, with the logo, face, or focal point centered. BlueSky clients may display the avatar inside a circle, so corners are not safe space.
Use a wide banner image. A practical starting canvas is a 3:1 layout such as 1500 by 500 pixels. Keep important text, faces, logos, and product details away from the top, bottom, and side edges because client crops can vary by screen size.
Keep profile images under the blob limit
BlueSky profile images are uploaded as blobs before the profile record points to them. A recent BlueSky app issue shows a banner upload being rejected when the blob exceeded 1,000,000 bytes, with the raw error saying the banner was too large.
See the BlueSky banner upload size issue for the 1,000,000 byte profile banner validation example.
For normal profile work, keep avatar and banner images under 1 MB. If a file is larger, export a smaller JPEG, reduce quality slightly, remove unused transparent canvas area, or resize the image before trying again.
Strip metadata before uploading
BlueSky's post-image documentation explicitly recommends stripping image metadata before upload and notes that clients and apps are responsible for sanitizing files today. That same habit is smart for profile images because photos can carry camera, device, and location metadata.
Use the free BlueSky image metadata and EXIF stripper before uploading profile images or scheduled visual posts.
Fix a blurry avatar
- Start from a sharp source image, not a screenshot of a screenshot.
- Crop the avatar as a square before upload.
- Center the important detail and leave padding around the edges.
- Export as a clean JPEG or PNG under 1 MB.
- Upload the new image, save the profile, then hard refresh the page.
If the avatar still looks wrong, upload a slightly changed file instead of the same exact file. A small crop or file-name change can help you confirm that the app is seeing a new image rather than showing a stale preview.
Fix a banner crop problem
- Build the banner as a wide 3:1 canvas.
- Keep the actual message centered, not pinned to edges.
- Avoid tiny text that becomes unreadable on mobile.
- Export under 1 MB.
- Check the profile on desktop and mobile before announcing the new design.
Banner crops are visual, not just technical. A file can upload correctly and still look wrong if the safe area is too tight.
What to do about stale profile caches
AT Protocol media blobs are stored with the account's PDS context and are commonly served through application CDNs, which may serve transformed versions. That means you may see an old avatar or banner briefly after uploading a new one.
Read the AT Protocol image and video blob guide for how blobs and CDN-served views fit together.
For larger media campaigns, keep profile-image troubleshooting separate from understanding advanced video blob encoding limits and decentralized file parameters so teams do not confuse avatar cache behavior with video preprocessing state.
- Save the profile after uploading the new image.
- Hard refresh the browser tab.
- Check the profile in a private window or another browser.
- Wait a few minutes if the old image still appears in one client.
- If nothing changes, re-upload a freshly exported file and save again.
Where ONYX fits after the profile is fixed
The profile image gets people to trust the account. The posting rhythm keeps them there. Once the avatar and banner are clean, use ONYX to plan useful posts, write in AI Voice, add alt text, and schedule approved visual drops from a content calendar.
Plan visual profile updates with the BlueSky content calendar template after your avatar and banner are ready.