# Introduce coworkers with Connections

> Introduce coworkers in Slack on a schedule, choose who gets matched, and see how rounds went.

Audience: Workspace administrators

Canonical: https://shuffl-rebuild.vercel.app/docs/connections

<a id="program"></a>
## Create an introduction program

1. In Manage, open Connections and choose New program. Start from a template such as Cross-team coffee, Meet someone new, Lunch groups or Leaders host small groups, or ask Mello in Chat to draft one from a sentence.

2. Pick the Slack channel whose members take part. Public channels are listed; for a private one, invite Shuffl first. Active members with Shuffl access take part, except bots, people who left the channel and people taking a break.

3. Choose the matching, group size and schedule, then write the introduction. The preview shows the message as it will look in Slack.

4. Choose Start program to schedule the first round, or Save draft. Starting sends nothing right away.

Connections needs the Shuffl app in Slack. Introductions go out as Slack group messages; nothing is sent from the web.

- [Open Connections](https://shuffl-rebuild.vercel.app/app/manage/connections)

- [Connect Slack first](https://shuffl-rebuild.vercel.app/docs/slack)

<a id="matching"></a>
## Choose who gets matched

Prioritize new connections puts together people who have not met through Shuffl yet. Connect across teams or departments prefers people from different parts of the company. Hosted puts one host in each group to arrange the meeting.

Groups hold 2 to 8 people, with an optional extra person so nobody is left out. Keep coworkers apart can avoid, or never allow, groups of managers and their direct reports, teammates or people in the same department.

On the program page, People lets you pause or resume one person, and Never introduce keeps two people out of the same group in every program.

<a id="schedule"></a>
## Set the schedule and review rounds

A program runs every few days, weeks or months in the time zone you choose. Monthly schedules can repeat on the same date, the same weekday position or the last weekday. The program page shows the next introduction.

Preview groups shows a possible arrangement before a round; Try another arrangement reshuffles it. Run now starts a round by hand. Round history shows each group and whether its message was delivered, with Retry known failures.

Insights counts who is taking part, introductions made, first-time pairs and introductions across teams, by week and per program.

- [Open Connections insights](https://shuffl-rebuild.vercel.app/app/manage/connections/insights)

<a id="historical-rounds"></a>
## Read preserved historical rounds

Workspace administrators can open Historical rounds in Connections to review records preserved from the previous Shuffl. Each round keeps its recorded groups and membership rows, including repeated membership records and unresolved group references.

Recorded message flags and source dates do not establish delivery, cancellation or a final outcome. Unknown values remain explicit. Source people stay unlinked until their connection to a current person has been proven; historical observations do not affect current participation or matching.

- [Open Historical rounds](https://shuffl-rebuild.vercel.app/app/manage/connections/history)

<a id="employees"></a>
## What employees see

An introduction arrives as a Slack group message that mentions everyone in the group, with a line about each person from their profile and, when calendars are connected, a link to pick a time. Someone without a bio gets a private nudge to add one.

People can take a break from a program on the Home tab of the Shuffl app in Slack: until they are back from out of office, for a round or two, for a month, or until they resume. A break keeps them out of new introductions and nobody else is told.

Slack message, Introduction (Each new group, in a group DM; Every round of a Connections program):

```text
<@UALEX>, <@UJORDAN>

A little time to meet someone new. Find 20 minutes this week to say hello.

Something to start with: you both mentioned *hiking*.

<https://shuffl.ai/schedule|Pick a time for your group> — Connect your calendar, or suggest a time here.
```

```text
*Alex Kim* (they/them) · Product designer, Growth · 3 years here · <https://shuffl.ai/app/people/alex|View profile>
Working on the new signup flow · Ask me about Figma, climbing

*Jordan Lee* · Support lead, Customer · 8 months here · <https://shuffl.ai/app/people/jordan|View profile>
I help customers get unstuck and I love a tidy spreadsheet.
```

Slack message, Add your bio (Someone introduced without a bio, privately; Right after their introduction):

```text
Your introduction went out without a bio. Add a few lines so the people you meet know a little about you.
```

<a id="onboarding"></a>
## Onboard new hires

Onboarding is its own program type in Manage, with a buddy invitation, an introduction and a check-in for each new hire. It has its own guide.

- [Onboard new hires](https://shuffl-rebuild.vercel.app/docs/onboarding)

## Related guides

- [Connect Slack](https://shuffl-rebuild.vercel.app/docs/slack)

- [Onboard new hires](https://shuffl-rebuild.vercel.app/docs/onboarding)

- [Communities](https://shuffl-rebuild.vercel.app/docs/communities)

Agent documentation index: https://shuffl-rebuild.vercel.app/llms.txt