Docs
Everything Scalendar can do, written down.
Five-minute install. Two-minute first event. The rest of these docs are for when you want to do something specific.
Install Scalendar
You'll need to be a Slack workspace admin or owner to install Scalendar. The install takes about 30 seconds and asks for a small set of permissions — listed in plain English below.
- Click any Add to Slack button on this site.
- Pick the workspace you want to install into.
- Review the permissions, then click Allow.
- You'll land on our thank-you page. You're done — head to any channel and type
/calendarto get started.
Permissions we ask for
Slack shows you this list before you approve. Here it is up front, no surprises — seven permissions, each tied to one specific thing Scalendar does:
| Permission | Why we need it |
|---|---|
| Slash commands | So /calendar works. |
| Send messages | Posting event announcements and reminders to your channels. |
| View channel info | Knowing a channel's name so your calendar knows where it lives — we never read message history. |
| Join channels | Scalendar joins a public channel before posting a reminder there. |
| View people | Display names, timezones (so everyone sees event times in their own timezone), who's an admin, and your workspace's member count for pricing. |
| Send direct messages | Premium reminders sent to specific people, and a fallback so reminders still reach the event creator if Scalendar can't post in the channel. |
| View email addresses | One use only: pre-filling your own email when you contact support from inside Slack. |
For the long-form legal version, see our privacy policy.
Your first calendar
Calendars live inside Slack channels. Open the channel you want to give a calendar — say #team-launchpad — and run:
Give it a name (emoji welcome — 🎉 Social Events works great), an optional description, and choose who can add events:
- Everyone — anyone in the workspace can add events.
- Only me — just you and workspace admins.
- Specific people (Premium) — a hand-picked list.
Everyone can always view events regardless. Hit create, and optionally announce the new calendar in the channel.
On the Free plan a workspace can have 2 calendars (one per channel). Premium removes both limits — including multiple calendars in a single channel.
Adding your first event
In any channel with a calendar, run /calendar add — or click any Add event button you see around Scalendar. You'll get a simple form:
- Title — what is it?
- Start / End date & time — events can span multiple days, so an offsite or conference works just as well as a stand-up.
- Calendar — which calendar it belongs to (pre-selected when there's only one).
- Category (Premium) — tag events like Standup or Social; create new categories right from the form.
- Description — optional, but nice for context.
- Reminder — see below.
- Post to channel — tick it to announce the event when it's created.
Everyone sees event times in their own timezone, automatically.
Slash commands
Everything Scalendar can do, from the keyboard:
| Command | What it does |
|---|---|
/calendar | List this channel's calendars. |
/calendar view | Upcoming events across the channel's calendars. |
/calendar view Marketing | Just the named calendar. |
/calendar add | Add an event (add a calendar name to pre-select it). |
/calendar create | Create a calendar in this channel. |
/calendar category | Manage event categories (Premium). |
/calendar billing | View and manage your subscription (admins only). |
/calendar help | A full guide, inside Slack — including a direct line to support. |
Inside the calendar view you can browse by today, this week, this month, and past or upcoming months.
Permissions
- Anyone in the workspace can create a calendar (plan limits apply).
- A calendar is managed — edited, deleted — by its creator and workspace admins.
- Adding events follows the calendar's setting: everyone, only the creator, or specific people (Premium).
- An event is edited or deleted by its creator and workspace admins.
- Guests can view everything but can't create or change anything.
- If a channel is archived, its calendars go read-only (and reminders stop); unarchive and everything picks back up.
Reminders
Reminders arrive as a channel message shortly before an event starts.
- Free — tick the reminder box on any event for a channel reminder 15 minutes before it starts.
- Premium — up to 3 reminders per event, each with its own timing (from 5 minutes to a week before), sent to the channel or to specific people as direct messages.
If Scalendar can't post in the channel, it sends the reminder to the event's creator directly so nothing is missed.
App Home tab
Click Scalendar in your Slack sidebar to open the Home tab:
- Your next 10 upcoming events, filterable by calendar, with one click into any event.
- Every calendar in channels you're a member of, grouped and filterable by channel — calendars in channels you're not in stay private to their members.
- Admins also see workspace stats (calendars, events, this month's activity) and the plan/billing summary.
Plans & billing
See the full breakdown on the pricing page. Billing is per workspace, priced by workspace size (guests don't count), monthly or annual — annual gets you 2 months free. Payment runs through Stripe; admins manage everything — invoices, card details, cancellation — via /calendar billing. If your workspace grows or shrinks into a different size bracket, the price adjusts automatically at your next renewal, never mid-term, and you'll get an email first.
Uninstalling
Open Apps in your Slack workspace settings → Scalendar → Remove app. Your calendars and events are deleted immediately. If you had a subscription, it's automatically stopped so you will never be billed again — you keep Premium for the period you've already paid for.
Security
- Slack access tokens are encrypted at rest (AES-256).
- HTTPS everywhere, TLS 1.2 or higher.
- Every request from Slack is signature-verified before we act on it.
- Payments are handled entirely by Stripe — card details never touch our servers.
- We store the minimum: your calendars, events, and workspace name. Never your messages.
For the full write-up, see our privacy policy.
FAQ
Can Scalendar read my channel messages?
No. Scalendar only receives the /calendar commands you type and the events you explicitly create. Regular messages are never visible to it.
Will it work in private channels?
Yes — invite Scalendar to the private channel first (/invite @Scalendar), then use it as normal. Calendars in private channels are only ever visible to that channel's members.
Can an event span multiple days?
Yes — just pick an end date on a later day. Offsites, conferences, and holidays all work.
Can I export to Google Calendar or Outlook?
iCal export is on our roadmap. Two-way sync with Google and Outlook is the release after that.
Do you support multiple Slack workspaces?
Yes — install Scalendar separately in each workspace. Billing and calendars are scoped per workspace.
Get support
The fastest route: run /calendar help in Slack and hit Get Support — it opens a short form and we'll reply straight to your email. Or email hello@scalendar.app directly. We aim for a 48-hour first response.
Ready to stop reading and start scheduling?
The fastest way through these docs is to install Scalendar and try the commands yourself.
Add to Slack