Mastodon server admins can add their own custom artwork so that links and bookmarks to their website show up in their own style instead of using Mastodon’s default artwork.
This is a really good idea for any server that wants to have a public identity, and even on single-user servers it can be fun to make it look like your own style. The default artwork is okay, but because it’s there by default it can deprive your site of its own identity. Adding your own artwork helps tell people that you are committed to your server.
How to customise your server’s artwork
- Log into your server’s website or web app with your admin account
- Click on ⋯ More and then Administration (if you’re using a phone click ☰ first)
- Click on Server Settings (if you’re using a phone click ☰ first)
- Scroll down to the sections marked Server thumbnail, Favicon and App icon
- Click the Browse buttons on the icons and thumbnail artwork and upload the images you want to use. You don’t have to upload them all, just upload what you want to customise.
- Click Save changes button at the bottom
- Click on Appearance tab at the top
- Choose a Default theme (users can still set their own theme, this is just the default one). “Automatic” means it uses dark or light depending on what the person viewing the site has chosen on their own system.
- If you’re a techy person or you’re using ready-made code, you can add additional CSS in the Custom CSS box
- Click on Save changes button at the bottom
What does “Server Thumbnail”, “Favicon” and “App Icon” actually mean in practice?
- Server Thumbnail: The artwork which appears in link previews and in Mastodon server listings on websites and apps. It helps get across what kind of server you run. This is probably the most important to customise.
- Favicon: This is the icon that appears when people bookmark your server’s website on their web browser.
- App Icon: This is the icon that appears on phones or tablets if people install your server’s website as a web app.
Should I use AI to generate artwork?
No. AI-generated images put people off joining, as they are almost all based on stolen artwork and cause significant damage to the environment. Even the simplest human-made artwork will give a better impression of your server than AI.
Where do I get artwork from?
You can use your own art, or your own photos, or commission an artist to create something.
If you’re nervous about using your own artwork and can’t afford to commission anything, you might want to look for public domain or creative commons images on Wikimedia Commons ⧉ . These are human-made and available with the permission of their creators.
Can admins add extra themes?
Yes, there are ready-made themes and themes can be created, though it may require tech skills to add or create them. See the custom CSS guide for more details.