> ## Documentation Index
> Fetch the complete documentation index at: https://cakeday.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Cake Day settings for your workspace

> The Settings page at cakeday.io/app/settings controls celebration channels, post schedule, pause state, voice preset, team rules, custom GIFs, and custom branding.

The Settings page at [cakeday.io/app/settings](https://cakeday.io/app/settings) is where you configure how and when Cake Day posts shoutouts, and — on higher plans — how those shoutouts look and sound. The page is organized into three tabs: **General**, **Voice & branding**, and **Custom GIFs**.

<Note>
  Running `/cakeday setup` in Slack redirects to the setup wizard if your workspace hasn't completed initial configuration, or to the dashboard if setup is already done. Running `/cakeday settings` always redirects directly to the Settings page.
</Note>

## General

### Celebration channels

**Birthday channel** — the Slack channel where Cake Day posts birthday shoutouts. This field is required.

**Work anniversary channel** — the Slack channel for work-anniversary shoutouts. On Starter and above you can choose a different channel from your birthday channel. On Free, Cake Day uses a single channel for both event types.

The channel picker only shows channels the Cake Day bot has been added to. If you don't see a channel you want to use, add the bot to it in Slack first, then return to Settings.

### Post schedule

**Post time** — the time of day Cake Day sends shoutouts (for example, 9:00 AM). All celebrations for that day go out at this time.

**Timezone** — the timezone Cake Day uses to evaluate the post time. Set this to your workspace's primary timezone so shoutouts land at the right moment for your team.

### Pause / resume

The **Live / Paused** toggle at the top right of the General panel lets you stop all shoutouts without changing any other settings. While Cake Day is paused:

* No birthday or anniversary posts are sent.
* The paused state is visible to your team in `/cakeday help` and the Slack Home tab.
* Your roster, channels, and schedule are preserved and ready when you resume.

Flip the toggle back to **Live** to resume posting.

## Voice & branding

The Voice & branding tab is split into three sections. Each is plan-gated independently — you don't need Pro to shape Cake Day's tone.

### Voice preset

The **Voice preset** picker controls Cake Day's overall tone. Pick one of four curated presets — every workspace gets this, on every plan, including Free.

| Preset                | Vibe                                              |
| --------------------- | ------------------------------------------------- |
| **Balanced**          | Warm and celebratory. The default Cake Day voice. |
| **Professional**      | Formal and corporate-safe. Minimal emoji.         |
| **Playful**           | High energy. More emoji, more hype.               |
| **Warm & close-knit** | Sincere and heartfelt. Quietly celebratory.       |

Click a preset to switch — Cake Day saves the change immediately and the next scheduled shoutout uses the new tone. Use `/cakeday test @yourself anniversary` (or `/cakeday test @yourself` for a birthday) to preview the effect.

### Voice & rules (Pro)

The **Voice guidance** field lets you write a short prompt — up to 2,000 characters — that adds team-specific rules on top of the chosen preset. This is for things the preset can't know: nicknames, sign-offs, never-say words, inside references.

Click **See examples** above the input for inspiration. The kinds of things that belong here:

* **Team name & sign-off** — *"We call ourselves the Pack. Sign off rally lines with — the Pack 🐺."*
* **Never-say rules** — *"Never use 'crushing it', 'killing it', or corporate phrases like 'synergy'."*
* **Always-do rules** — *"Mention how many years they've been with us as 'X trips around the sun'."*
* **Team vocabulary** — *"We're a coffee company — slip in a reference to espresso or the roastery when it fits naturally."*
* **Cultural fit** — *"Skip US-specific references and sports metaphors — we're a remote team across timezones."*
* **Inside jokes** — *"Our team mascot is a chili pepper 🌶️ — drop one in occasionally."*

Your rules layer on top of the preset, but the preset still owns sentence shape, energy, and emoji density. Cake Day's safety rules — never fabricating facts about a teammate, never claiming personal knowledge, length limits, profanity filters — always apply on top of everything.

This field is Pro-only. On lower plans it's locked and an upgrade banner shows in its place.

### Custom branding (Pro)

**Display name** — the name the bot uses when posting shoutouts (e.g., "People Team" instead of "Cake Day"). Leave blank to use the default.

**Company name** — the name of your organization, used in anniversary messages so they can read naturally as *"5 years at Acme!"* instead of generic *"5-year milestone"*. Optional; leave blank to skip company references entirely. Only used in anniversary shoutouts — birthday messages never reference your company name.

**Avatar icon** — a custom image (PNG or JPEG, max 1 MB, square recommended) used as the bot's profile picture when posting. Upload a new icon or remove the current one from this panel.

Custom branding applies to real scheduled shoutouts only. Previews from `/cakeday test` always render with the default Cake Day identity due to a Slack platform limitation. The company name does appear in `/cakeday test` previews, since it's part of the generated message text rather than the bot's posting identity.

All three fields are Pro-only and locked on lower plans.

## Custom GIFs (Growth and above)

The Custom GIFs tab lets you build a GIF pool that Cake Day draws from when composing shoutouts. Growth workspaces can store up to 15 GIFs; Pro workspaces up to 50.

### Adding GIFs

You can add GIFs two ways:

* **Upload your own** — upload a GIF, PNG, JPEG, or WebP file (max 8 MB).
* **Search Giphy** — search Giphy directly from the dashboard and add a result to your pool.

When adding a GIF, you can tag it as **Birthday**, **Anniversary**, or **Both** to control which event type it appears in.

### GIF pool mode

The mode toggle controls how Cake Day uses your custom GIFs:

| Mode                    | Behavior                                                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Mixed with defaults** | Cake Day chooses from your custom GIFs and the curated default library.                                                                    |
| **Use only my GIFs**    | Cake Day only uses GIFs from your custom pool. If your pool is empty or all GIFs are disabled, Cake Day falls back to the default library. |

### Managing your GIFs

Each GIF in your pool can be:

* **Enabled or disabled** — disabled GIFs are excluded from shoutouts but stay in your pool.
* **Labeled** — add a short name to keep your pool organized.
* **Retagged** — change the event type (Birthday, Anniversary, Both) at any time.
* **Deleted** — permanently removed from your pool.

This feature is locked on Free and Starter. An upgrade prompt is shown in its place.