Settings
Finding your settings
Open Settings from your account menu. Each section has its own page, listed down the side.
Profile
Settings → Profile controls what people see at /@handle:
- Display name and avatar (Change avatar).
- A header image (Upload header).
- Bio, in Markdown, up to 500 characters.
- Up to 4 Links.
- Pronouns and Location.
- Up to 3 Pinned items: messages, lists or documents shown at the top of your profile.
- Your Handle: 3–30 letters, numbers or underscores. You can change it once every 30 days. Your old handle redirects to the new one for 90 days and can't be claimed by anyone else for a while after that.
Account
Settings → Account holds your email, password, two-factor authentication, sessions, the accounts signed in on this device, and account deletion. See Account & security.
Subscription
Settings → Subscription shows your subscription's status and renewal date. Manage billing opens the SubstratalApps billing portal.
Preferences
- Theme: light, dark or system.
- Time zone and Language. Scheduling uses your time zone.
- Default message visibility for new messages.
- Messages per page in timelines.
- Max message length: from 100 to 5,000 characters. The default is 666.
- Default timeline, and Remember the last tab I open.
- Show replies in timeline.
- Default cross-posting targets: the connected accounts new messages go to unless you change them.
- Show link previews, Autoplay videos and GIFs, and Reduced motion.
Notifications
Settings → Notifications has a grid of every notification type against each channel: in-app, push and email. Email can be Immediately, Daily digest or off. You can also:
- turn on push notifications for this device
- pause push notifications for a while
- set quiet hours, when push notifications wait
- choose the Daily digest time
See Notifications for each type and its defaults.
Privacy & Safety
- Private account: only approved followers see your bio and posts.
- Who can message you and Who can mention you.
- Whether to appear in suggestions and people search.
- Ask search engines not to index my profile.
- Your blocked and muted accounts, and muted words and hashtags.
See People and Reporting & safety.
Integrations
Settings → Integrations connects Mastodon, Bluesky, LinkedIn and X for cross-posting, and GitHub for GitHub-backed lists. For each account you can Verify the connection, Reconnect it, Disconnect it, or make it the default. These accounts are only used for cross-posting and lists, never for signing in. See Cross-posting.
Developer
Settings → Developer manages API access for the il CLI and your own scripts:
- API tokens: up to 20, each with its own permissions, expiring after 30, 90 or 365 days. A new token is shown once, so copy it straight away. Revoke a token at any time.
- Webhooks: up to 5 endpoints that receive signed events, with delivery history and Redeliver.
- Usage of the API by token and by route.
The API reference is at Developers.
Data
Settings → Data exports your content and imports files. See Export your data.
Widgets
Settings → Widgets chooses which widgets appear in the Home sidebar, and their order: Clock / Sun & Moon, Trending, Who to follow and Hacker News.