# Set up your workspace

> Name your company, set up its first workspace and pick up where you left off.

Audience: Workspace administrators

Kind: Tutorial

Canonical: https://shuffl.ai/docs/getting-started

<a id="create"></a>
## Name your company

1. Sign up with your work email and a password, or with Google or Slack. A browser check may ask for one click. Verify your email, then sign in.

2. Name your company. Shuffl suggests a name from your work email and creates the company with its first workspace.

3. If you like, tell us how you heard about Shuffl. It’s optional.

4. If you were invited, follow the invitation instead. Company owners and administrators can add another workspace later.

5. Shuffl opens workspace setup, one of the pages administrators, HR responders and Knowledge verifiers reach from the HR workspace. Employees use Home.

- [Create an account](https://shuffl.ai/sign-up)

- [Open workspace setup](https://shuffl.ai/app/setup)

<a id="checklist"></a>
## Work through the checklist

1. Add your handbook first, since Mello answers only from what you publish. Choose Upload a file or Add your website, or drop a file on the page.

2. Check the draft, then publish it.

3. Imported but not published yet? The step shows how many drafts wait and offers Review drafts.

4. Try Mello. Ask something your handbook answers, on the web or in a direct message to Shuffl in Slack. A cited answer completes the step.

5. Choose Connect Slack and approve the app. Eligible members get access automatically. To approve people manually, turn off Automatic access for Slack in People → Sync first.

6. Invite a coworker. Their access turns on when they accept, or turn it on for people already waiting in People.

7. Owners get HR requests by default. If nobody can receive them, open People, choose a person and turn on HR responder under Roles.

8. To hand setup to Claude Code or another agent, choose Show prompt, then Copy prompt, and paste it into the agent.

9. It works through the steps over MCP and asks before it publishes or invites anyone.

10. Under Also turn on, start Pulse, Connections, Onboarding, Celebrations and Communities when you’re ready. Each has its own guide.

Workspace setup lists what a workspace needs before employees get value from it. Progress follows your saved settings, so you can leave and come back.

- [Open workspace setup](https://shuffl.ai/app/setup)

- [Publish your first source](https://shuffl.ai/docs/knowledge)

- [Choose HR responders](https://shuffl.ai/docs/hr-requests)

<a id="slack-channels"></a>
## Bring your Slack channels over

If another app already runs coffee chats, shoutouts or celebrations in your Slack, workspace setup offers Bring them over.

Intros become a Connections program, shoutouts become a praise channel with the past year imported, and a celebrations channel gets birthdays and anniversaries once you turn them on. Choose Leave it to skip a channel.

To avoid matching people who already met, add the other app’s CSV report of past intros on the same screen. Shuffl keeps only who met whom, never the names or emails in the file.

Then remove the other app from Slack. Each Connections program starts once that app leaves its channel, so nobody gets two introductions.

People whose birthday the other app celebrated are asked privately whether Shuffl should keep it. For a private channel, type /invite @Shuffl in it first.

Slack message, Keep your birthday? (Someone the previous app celebrated, privately; Once, after switching from another app):

```text
Your birthday was celebrated in #celebrations on 14 March. Want Shuffl to keep celebrating it?
```

- [Bring your Slack channels over](https://shuffl.ai/app/setup/slack-channels)

<a id="resume"></a>
## Resume after an interruption

Sign back in and reopen Workspace setup in the same workspace. Retry the failed step there rather than creating a new workspace.

If progress moves backward, check the setting behind the step. A withdrawn document, a passed review date, a removed responder or a suspended employee reopens a step.

Home shows administrators the same progress, such as Finish setting up · 1 of 4, with the next step and a Continue setup button. Slack’s Home tab for Shuffl shows it too.

- [Open workspace setup](https://shuffl.ai/app/setup)

- [Find a recovery step](https://shuffl.ai/docs/troubleshooting)

<a id="migrated-workspace"></a>
## Coming from the old Shuffl

Signed up here before your team moved? A new account starts empty, with no Slack, schedule or pairings. Keep managing coffee chats in your current Shuffl until your team moves. You don’t need to connect Slack here; we message you in Slack when it’s time.

Coming from the old Shuffl? Administrators start in Workspace setup. Open Connections to review your programs, schedules and history, or Manage People sync to choose how people join. Continue down the same checklist for Slack, Knowledge and Mello.

Use Back to workspace setup to return after exploring. Done for now takes you Home and saves your introduction as seen for your account. You can reopen setup from Home at any time. Employees get their own getting-started cards on Home.

When Slack needs new permissions, a company admin can choose Update Slack permissions. Slack shows what you’re approving and returns you to setup afterward. Current permissions need no reinstall. Opening setup or finishing the introduction does not activate programs or change access or billing.

- [Open Connections](https://shuffl.ai/app/connections)

- [Review Slack connection steps](https://shuffl.ai/docs/slack#connect)

## Related guides

- [Rehearse before going live](https://shuffl.ai/docs/go-live)

- [Companies and workspaces](https://shuffl.ai/docs/companies-and-workspaces)

- [Connect Slack](https://shuffl.ai/docs/slack)

- [Review and publish knowledge](https://shuffl.ai/docs/knowledge)

- [Invite and enable employees](https://shuffl.ai/docs/employee-access)

- [Roll out Shuffl to your company](https://shuffl.ai/docs/rollout)

Agent documentation index: https://shuffl.ai/llms.txt

