How Roost works
A plain-language walkthrough of who can see what, why, and what you can change. The whole privacy model lives in this one page — read it once, refer back as needed.
Part 1
For members & families
New to Roost? Start here.
Three things worth doing in your first few minutes:
- Set how you show up. Open your Profile, set a preferred name if you go by one, and pick exactly what you share. (More in §1.)
- Find your people. Search any name from the top bar, or open your kid's class. (More in §10.)
- Make a circle. Group your carpool, your team, or the room parents — then make it a shared circle so everyone can see each other. (More in Shared circles, below.)
2. Within “Visible”: everyone in the directory vs. just your children's classes
When you're set to Visible, you also choose who can see you. If you have children in the directory, you get three options; otherwise the scope is just “everyone in the directory.”
- All members in the directory
- Every member in the directory at your organization can see you. This is the default for most opted-in members — it mirrors how the old paper school directory worked.
- Only guardians in my children's grade(s)
- All guardians whose kids are in the same grade as yours. Wider than class but narrower than the whole organization. Useful for middle and high school where homerooms don't mean what they did in elementary. Only shown if your directory has grades and you have children in it.
- Only guardians in my children's classes
- Only the guardians of your children's classmates can see you. If you have kids in multiple classes, all of those classes count. Best for members who want to connect with the immediate classroom crowd and nobody else. Only shown if your directory has classes and you have children in it.
3. Circles — your private groups
Circles are your own private groups of people you want to keep in touch with — the soccer carpool, the after-school pickup crew, the room-parent committee.
- Only you see your circles. Other members can't see which circles they're in, and they can't see your circles at all. Adding someone to a circle doesn't notify them.
- You only end up in a circle if the owner could find you when they added you. Someone can't add you to their circle if you weren't findable at the time. So your visibility settings still control who can even start a circle that includes you.
- Circles let an owner keep seeing you even if you go Private later. If a circle owner could see you when they added you and you later change your sharing to Private, you stay in their circle — but only your name shows. None of your contact info follows. The chip on your card explains why they can still see you at all.
- Cross-organization works. If you're a member at more than one organization in your district, a circle can include people from any organization you have access to.
- Send to a circle. “Email this circle” sends one BCC'd email to everyone in the circle. Saves you from looking up each email one by one.
Shared circles — a group that can see each other
A shared circle works differently from a personal one: everyone in it can see the other members. It's a private mini-directory just for that group — a club team, a committee, a neighborhood carpool.
- Invite by link or QR. Share a link (or show the QR code) and people tap to join. They can be at your school, another school in your community, or not on Roost at all.
- Guests welcome. Someone you invite who isn't on Roost can join as a guest — they just enter their name (and optionally a phone and school), no full account needed.
- You choose what you share. When you join, your name and school show to the other members; your email, phone, and kids are your choice (shared by default, you can turn any of them off).
- It can span schools. A shared circle can include families from different schools or communities — useful for a club team or any group that crosses school lines.
- The owner runs it — and can add co-owners. Whoever created the circle manages the members and the invite link, and can remove someone. They can also make another member a co-owner (look for the crown) so more than one person can help run it. You can leave a shared circle anytime.
- Owners can broadcast to the circle. The owner or any co-owner can use Broadcast to send one update by email to everyone in the circle — handy for a quick “practice is moved” or “forms are due.” Replies come back privately to whoever sent it; members can't reply to the whole group. (Regular members can still use “Email this circle” for a plain BCC'd email.)
4. Clubs & Events — groups, committees, and events
Clubs are public groups inside your organization — Football Boosters, Drama Parents, Class of 2027, Math Olympiad, Fundraising Committee. Anyone in your organization can find them, join, and send broadcasts to fellow members. They're what replaces “your kid's class” as the organizing principle once kids get older — or, in non-school organizations, the way committees and standing groups stay connected.
The simplest way to think about it: Circles are private (you build them, only you see them). Clubs are public to your organization (anyone can find them and join). Same underlying mechanic — a list of people — but different scope.
Three kinds live here:
- Clubs — a group to join (a shared interest or affinity group).
- Committees — roles to fill; people sign up to help or express interest in an open position.
- Events — one-time happenings (a carnival, a fun run, a book fair) with a date, time, and place. An event can stand alone or be put on by a committee or club — when it's tied to one, it shows nested right underneath. Events can carry up to three links (a sign-up page, a donate/pay link, the event website) and a location with a map link.
Use the All / Committees / Clubs / Events filter on the Clubs & Events page to focus on one kind, and committees/clubs show a “upcoming events” line when they're putting one on.
- Anyone in your organization can create a Club. Name it, pick an emoji, add an optional description. Administrators can clean up junk if needed.
- Joining is one click. Browse the Clubs list, see what's there, click Join club. No approval needed in this first version — you join, you're in. (We may add an “approval required” option per club later, for groups that want vetting.)
- What other members can see. Right now, the Club's roster shows the names of everyone who joined — nothing more. No contact info, no addresses. Members are people you're organized with, not people whose information you can mine. If you want to reach a specific Club member, go look them up in the regular directory (where your sharing settings still control what they see).
- Broadcasts go to the whole Club. An administrator (or in v2, any Club member) can send a broadcast email to everyone in a Club. The sender doesn't see individual recipient emails — the same BCC-with-count-only model as organization-wide broadcasts.
- Blocking applies to Clubs too. If you block someone, they'll never see you in any Club, even one you both joined. They don't see your name in the roster, your contact info, or the fact that you're a member. Their member count is silently off by one. This is the same invariant as the rest of the directory — block hides you, full stop.
- Leaving a Club is your call. Click into the Club's detail page and hit Leave club. You'll stop getting that Club's broadcasts immediately. You can rejoin later if you change your mind — the Club doesn't remember you left.
Why we built this: at elementary, the school day revolves around the classroom — one teacher, one room. By middle and high school, that's not how families connect anymore — and at a foundation or HOA, classrooms were never the unit to begin with. Clubs give activity- or committee-based groups a real home inside Roost — one that doesn't depend on a classroom structure.
5. Blocking someone
When you block someone, they can't see you in the directory — your card, your listings, and your kids' cards (the kids who aren't shared with the blocked person) all disappear from their view.
- It's one-way. Blocking is about what the blocked person sees, not what you see. You still see them normally (so you can keep track of events, committee work, classroom news, etc.).
- Shared kids stay visible. If you and the person you blocked share custody of a student, that student stays visible to them — co-parents legitimately need access to their kid's info. You're hidden from the student's family detail page on their end.
- Reasons stay private. If you note a reason when blocking, only you see it.
- Find blocked people in the Blocked circle. Your blocked list appears as a system circle below your regular circles. You can unblock from there or from the family detail page.
- Trusted Help listings respect blocks too. If you wrote a recommendation for a sitter, tutor, coach, or mentor, someone you've blocked won't see your name as the recommender — and a listing you authored about yourself is hidden from them entirely. The block carries through to the Trusted Help board, not just the rest of the directory.
- Administrators can still see everyone. District and organization administrators bypass blocks so they can manage the directory. Blocking is for member-to-member visibility, not for hiding from your organization's leadership.
6. Teachers and your own view
Two small but important rules that apply on top of everything above:
- Teachers are always visible. No matter your sharing settings, the teacher names on your kid's class page show up. Teachers don't have private contact info in Roost — just names. (Only applies to school organizations.)
- Your own view always wins. No matter how you've set your sharing, you can always see your own member card, your own kids (if any), and your own contact info. The visibility rules are about what other members see, not what you see.
7. Preferred names
Most of us go by a nickname. Roost surfaces it without losing the legal name.
Every guardian and every kid has an optional preferred name field. When it's set and different from the first name, Roost renders the name as First “Preferred” Last. For example, Robert with a preferred name of Bob renders as Robert “Bob” Smith in the directory, on class lists, and in club rosters.
Why both names show. A teacher who only knows the kid as “Robert” from the roster still needs to find him. Showing both keeps the searchable hook + honors the social name. Search matches either: typing “Bob” finds Robert; typing “Robert” still finds him too.
Where to set yours. Profile → Preferred name. Leave blank to render as First Last. Admins can set preferred names on behalf of family members from the Manage Families surface, with the same audit log as any other edit.
8. When an admin changes your info
What admins can edit on your behalf, what they can't, and how you find out.
School + district admins can edit your contact info on your behalf — name spelling, phone number, address, public notes. These are the kinds of edits a PTO president would have made by hand in the old days. Every change writes an audit row with the admin's name, what changed, and a free-text reason for sensitive fields. You can see your own audit history from your Profile (coming soon).
What you can change yourself. You don't have to wait on an admin to fix your own children's grade or teacher — set both from your Profile, under Your children. Pick the grade first and the teacher list narrows to that grade. Leaving the teacher blank is fine if you don't know it yet. These edits are audited the same way an admin's are, so your organization can see what changed and who changed it.
What an admin cannot do without your sign-off. An admin cannot widen your visibility for you. Specifically, they can't flip you from Private to Visible, can't broaden your visibility scope from class-only to school-wide, and can't turn on your email/phone sharing if you turned it off. Those changes only happen when you save them yourself, because broadening visibility is a consent decision that's yours alone.
What an admin can do that narrows. An admin can turn off your email/phone sharing on your behalf — for example, if you ask them to. Narrowing visibility is reversible by you whenever you want, so it's safer to let an admin help.
Changing your email address. Email changes go through a verification step on the new address. Admin proposes the change, Roost sends a magic link to the new address; clicking the link is what commits the swap. Your old email keeps signing you in until then. If your new email address is already in use by someone else on Roost, the change is rejected — same email can't belong to two accounts.
9. Changing your email address
Your email is how you sign in and how the directory reaches you, so changing it takes one confirmation step.
Today, an admin makes the change for you. If you signed up with the wrong address, or you're switching to a new one, ask an admin at your school to update it. (A do-it-yourself version is coming.)
You confirm it's really you. When the admin enters the new address, Roost emails a confirmation link to that address. Your email only changes after you click the link, which proves the inbox is yours. Until then, your current email keeps working exactly as before — nothing changes if you never click.
No two accounts can share an email. If the new address is already attached to someone else's account, the change is declined and the admin is told to use a different one.
You don't have to re-accept anything. Changing your email doesn't reset your privacy choices or ask you to agree to terms again — it's just a new address on the same account.
The confirmation link is good for 24 hours. If it expires, ask the admin to send a new one.
10. “I want to…” quick tasks
- …change who can see me
- Open your Profile (from the menu in the top-left of the directory). Pick your sharing default and scope. Save. Changes apply immediately.
- …find another member's contact info
- Search by name in the search bar at the top of the directory, or scroll the alphabetical list. If you don't find them, they may have chosen Private — try asking a mutual contact to add you to a circle you share.
- …add a child Roost is missing
- Open your Profile. Under Your children, choose Add a child Roost is missing and give their name and grade — they appear straight away. This is for a school where you already have a child: a new kindergartener alongside an older sibling, or a student the roster missed. For a child at a different school, that school has to approve you first, so use their request-access page.
- …start a circle
- On the Circles tab, click New circle, name it (and pick an emoji if you want), then add members from the member search.
- …block someone
- Open their member card, click Block next to their name (you can add a reason — only you see it). To unblock, open the system Blocked circle in your Circles list.
- …fix my kid's grade or teacher
- Open your Profile and find Your children. Pick the grade, then the teacher — the teacher list only shows teachers for the grade you picked. Leave the teacher blank if you don't know it yet. If the name itself is wrong, or your kid isn't listed at all, ask your administrator.
- …become an admin or board member
- Ask your organization's current admin to grant you a role from their Roles & permissions screen. The grant takes effect immediately and is visible in the role audit.
- …stop receiving broadcast emails
- Open any broadcast email and click the Unsubscribe from broadcasts link in the footer. Confirm the email it was sent to. You stay in the directory — this only silences future broadcasts from that organization. See Broadcast emails below for the fine print.
11. Trusted Help — sitters, tutors, coaches, and mentors your community vouches for
Trusted Help is a small, community-built list of the people families actually rely on — babysitters, tutors, coaches, music teachers, mentors, pet sitters, dog walkers, house sitters and yard help. There are two ways someone lands on it:
- You recommend them. Know a great sitter? Add a listing so other families at your school can find them. You show up as the person who vouched for them.
- They list themselves. A tutor or coach can post their own listing, which carries the names of any community members who've recommended them.
To add a listing: open the menu → Trusted Help → Add a listing. You choose what contact info to include.
Looking for help, not offering it
The other half of Trusted Help is the Looking for help tab, where families ask for what they need instead of waiting for the right listing to appear. Need a sitter for one Friday, or a math tutor for the term? Post it there.
- Everyone at your school sees it. Including families who've kept themselves out of the directory. A request is something you chose to publish, so it isn't limited to the people who can already look you up.
- Your name is shown; your contact details are not. When someone taps I can help, we email you and they go on the reply line. You write back if you want to. Nobody's phone number or address appears anywhere, and if you don't reply, you never had to turn anyone down out loud.
- It comes down on its own. A request with a date disappears just after that date; an open-ended one lasts a month. Found somebody sooner? Tap Found someone and it stops collecting replies.
- Blocking works both ways here. Unlike a listing you authored, a request is hidden in both directions: you won't see theirs and they won't see yours. Everything on this board leads to somebody contacting somebody, so a block closes it off entirely.
To ask for help: open the menu → Trusted Help → Ask.
Sharing across schools in your district
You can extend a listing beyond your own school to specific other schools in your district — handy when, say, your high-schooler babysits for families at the nearby elementary.
Requests travel the same way, and this is often the point of them. The families who can answer a sitter request are the ones with high schoolers, who are at a different school from the family that needs one. When you post on the Looking for help tab you can pick other schools in your district to post at too. Only schools that have turned this on appear, and if none have, the option isn't shown at all.
- Only listings about you or your own family. You can share your own listing, or one for your own kid. A recommendation you wrote about someone else stays at your school — third-party listings never fan out across the district. (Promoting an outside business district-wide is what Sponsors is for, and that's set up by your PTO.)
- You pick exactly which schools — for example just the one or two nearest neighborhoods — and only schools that have chosen to accept outside listings even appear as options. It's opt-in on both sides.
- It shows where it came from. At a receiving school, your listing carries a “Shared from [your school]” badge so families know the context.
- No district-wide people search. This shares a listing you chose to extend — it doesn't make you findable across schools. Nothing about you crosses a school line unless you put it there.
Good to know. Trusted Help is recommendations from your community — not a vetted or background-checked service. Treat each listing like an introduction from a neighbor: meet, ask questions, use your judgment.
One detail on blocking: if you've blocked someone, they can still see your name on a Trusted Help listing you authored — a listing is a public vouch you chose to put your name on, so it's treated differently from the rest of the directory, where a block hides you.
Part 2
For admins
12. Admins
Some accounts have wider visibility than regular members — to run the directory, organize events, or troubleshoot. Different organizations use different names for these roles (PTO board, foundation board, HOA board, etc.); the underlying powers are the same.
- District admin
- Manages all organizations in the district. Sees every member at every organization they manage. Sees email + phone for every member regardless of the member's sharing toggles (so they can reach out about real issues). Doesn't see private addresses unless the member has chosen to share them.
- Organization admin
- Manages a single organization. Same visibility rules as district admin but scoped to their organization. Usually the PTO president, foundation executive director, or whoever bought the Roost subscription. Organization admins can also update your data on your behalf — fixing a grade, swapping a teacher after a roster change, correcting a typo in a phone number you can't edit yourself. Grade and teacher you can also set yourself, from your Profile under Your children; email your admin for anything else that looks wrong.
- Board member
- Read-only elevated access: sees opted-in members even if they chose a narrower scope (so the board can email a grade, class, or cohort). No edit powers — they can't change other members' data. Replaces the old “everyone shares the admin password” pattern with proper individual accounts. At schools this is the PTO board; at foundations and HOAs it's the board.
- Early tester
- Same elevated visibility as a board member. Used while an organization is in the pre-launch period and a handful of trusted members are validating the roster before the rest of the organization is invited in.
- Teacher
- Imported from a school's roster, not granted manually. Teachers appear on class and grade pages so families can put names and faces together. Teachers don't have logins by default — they're shown for context, not for communication through Roost. Only applies to school organizations.
Every role change is logged. Administrators can see who granted whom which role and when, on the Roles & permissions page. This is the accountability trail that replaces a shared password.
End-of-year rollover
At year-end, the rollover advances every student a grade, graduates the top grade out, and clears homerooms so no one shows in last year's class (you set new teachers on your next roster import). Nothing changes until you review and confirm, and an applied rollover can be undone — most recent first.
If you edit a student after a rollover: undo is careful about it. If you change that kid's grade (or mark them inactive), undo leaves them exactly as you set them and reports a conflict rather than overwriting your edit. Any other change — an address, a name, a note — is always kept; the rollover and its undo only ever touch grade, school year, and homeroom.
13. Broadcast emails
Administrators and board members can send broadcast emails to members of their organization — “field day is Friday,” “volunteer slots open for spring carnival,” “quarterly board meeting Thursday.” There's a piece of this that's easy to miss, so we want to be upfront about it.
Broadcasts don't respect your Visible / Private setting. If your email is in the directory, you'll receive broadcasts — even if you set your sharing to Private. The Visible / Private setting controls what other members see when they look you up. It does not silence the broadcasts.
- Why this is decoupled. An organization's leadership has to be able to reach every member for time-sensitive things — schedule changes, snow days, urgent volunteer asks. If turning “Private” muted those, leadership would lose half their audience overnight. So directory privacy and broadcast reach are two different switches.
- Senders never see your email address. Broadcasts are sent with everyone in BCC. The admin who composed the message sees a count (“reached 263 members”) and aggregate delivery stats, never an individual recipient list. Other members who received the same broadcast also don't see your address. Your email stays as private inside the broadcast machinery as it is in the directory listing.
- Replies go to one inbox. When you reply to a broadcast, it goes to the single reply-to address your organization chose — usually something like
president@yourorg.org. Other recipients don't see your reply. - Unsubscribing is one click. Every broadcast has an unsubscribe link in the footer. Click it, confirm the email address it was sent to, and you're off the broadcast list for that organization. You stay in the directory — only the broadcasts stop.
- Going Private is a separate decision. If you want to be off the broadcast list and hidden from the directory, do both: change your sharing to Private (from your Profile) and click the unsubscribe link in any broadcast. They're independent.
- Volume caps. Each organization has a monthly cap on broadcast sends — your administrators can't accidentally blast you 50 times in a week. Caps are visible to administrators on the messaging settings page.
- Schedule a broadcast for later. When composing, an admin can choose “Or schedule it for later” on the confirm step and pick a date and time (in their own time zone) instead of sending right away — handy for drafting a back-to-school note in the evening and having it go out the next morning. Scheduled broadcasts wait under a Scheduled section in the broadcast list, where the sender can edit or cancel them before they go. Roost checks for due sends every few minutes, so it goes out at — or just after — the chosen time.
- Welcome the families heading your way (feeder schools). A school can broadcast to a single grade at one of its feeder schools — for example, a high school PTO messaging the middle school's current 8th-grade families before they move up. It only works when both sides opt in: the feeder (lower) school's admin turns it on under Organization → Cross-school sharing, and the sender picks the feeder school and grade. The email tells each family why they're getting it (“your child is in grade 8 at [school], and [school] is their next school”). To be clear: this is a grade-targeted broadcast within a configured feeder relationship — it does not let anyone search or see other schools' families.
- Customize the sender for one broadcast. On the compose screen, “Customize sender & replies” lets the sender give a single broadcast its own From name and reply-to address (e.g. so a room parent or committee gets the replies) without changing the school's defaults. Leave it blank to use the school defaults.
Building a newsletter
A short note is fine as plain text. For the longer monthly one, choose “Build a newsletter” on the compose screen.
The part that makes this different from a flyer: your sign-up numbers stay right on their own. A newsletter usually goes out of date between writing it and sending it. You write “we still need 12 people for the carnival” on Sunday, it sends Tuesday, and four families signed up in between. In Roost, the volunteer and event pieces point at the real thing instead of copying it, and the numbers are read at the moment the email is built. So “17 of 20 spots open” is true when it lands in the inbox, not when you started typing.
- Volunteers needed — the live job list. Point this at a club or an event and the email lists its jobs with the real count beside each one: Ticket redemption, 17 of 20 spots open. Roost reads the sign-up sheet when the email is built, so nobody has to remember to update a number. You can cap how many jobs are listed and hide the ones already full — and when some are hidden the email says “sign up or see all 11 jobs” rather than quietly showing a shorter list. Fill a shift after you write the newsletter and before it sends, and the email that arrives already knows.
- Event — pulled from the real event. Pick an event already in Roost and the block fills in its name, date, time and location, with a link through to the event page. Change the start time in Roost and you do not have to remember you also wrote it into a newsletter.
- Contact card — filled in for you. Your organization's address, phone, website and social links, taken from Organization. You type nothing, and it cannot go stale.
- Start from a shape, not a blank page. Pick Monthly newsletter, Call for volunteers, Event announcement, Short update, or Blank. These fill in the structure and leave the writing to you — deliberately, so nobody ever mails out “Title goes here.”
- The rest of the pieces. A header band, a big opening, section headings, text, a picture beside text, a picture on its own, a highlighted callout, a button, and a divider. Add, reorder, and delete them in any combination.
- See it as families will, while you write. The panel beside you is not an approximation — it is rendered by the same code that builds the real email.
- It uses your colors. Bands pick up the accent color from Organization → Brand, and you can recolor them from the preview. Roost chooses the text color for each band by measuring contrast, so a header can't end up unreadable no matter which color you pick.
- Pictures. Drop in a photo or a design exported from anywhere — Canva included. Large phone photos are shrunk in your browser before uploading, so it takes a couple of seconds rather than thirty. Alt text is required — a sentence describing the picture, for families using a screen reader and for the many mail apps that don't load images by default.
- Links can be typed the way people say them.
www.example.comis fine; Roost fills in the rest. - Save a draft at any point. Half-finished blocks and all. Close the tab, come back tomorrow, and everything is where you left it, including the audience you had chosen. Your work is also kept in the browser as you go, so a dropped connection doesn't cost you the evening.
- Show it to someone before it goes out. Share for review creates a link you can send to your president or principal. They don't need a Roost account. They see the email exactly as families will and nothing else — not the audience, not the recipient count, and no way to send it. The link expires after 14 days and you can switch it off at any time.
- Save your own layout as a template. Once you have the monthly one looking right, save it under a name and start from it every month. Templates belong to your organization, so anyone who can send can use them. A template remembers the layout and your colors — never a subject line and never an audience, because those two should be a fresh decision every single time.
- Send yourself a test first. Always worth it. Phones, Gmail and Outlook each render email slightly differently, and a test costs nothing.
- What you learn afterwards, and what you don't. You'll see how many people a newsletter reached and a total count of link clicks — useful for knowing whether the sign-up link is working. Roost does not tell you which family clicked, or who opened it. That's deliberate. Whether a specific parent read your newsletter is not something your PTO needs to know.
14. Sponsors — local businesses your organization supports
Sponsors are local businesses your organization has a relationship with — a pediatric office, a tutoring service, a pizza place hosting a fundraiser night. When your administrators add sponsors, a Sponsors tab appears in the directory alongside Families, Trusted Help, and Clubs.
- The tab appears only when there are sponsors. If your organization hasn't added any yet, the tab stays hidden — no empty pages, no confusion. As soon as the first sponsor is added, the tab shows up.
- Tap-to-call, tap-to-route, tap-to-visit. Each sponsor card has phone, address, and website fields where the admin filled them in. Tapping the phone opens your dialer. Tapping the address opens Maps with directions. Tapping the website opens your browser. No copy-paste.
- Browse by category. If there are enough sponsors to need filtering, you'll see pills at the top — Restaurants, Healthcare, Tutoring, etc. Tap one to see only that category. Tap “All” to see everything.
- Offers and promotions. If a sponsor included a promo (“Show this screen for 10% off,” “Family Night Friday — 10% to PTO”), it appears highlighted on the card. The sponsor sets these themselves and your organization curates them.
- Roost doesn't vet sponsors. The relationship is between your organization and the business. Treat each one like an introduction from your school community — meet, ask questions, and trust your judgment. Same approach as Trusted Help.
- Your information stays private. Sponsors are not Roost users. They have no access to member information. When you tap to call or get directions, your phone or browser does that locally — nothing routes through Roost.
15. For admins: setting up your organization
If you're an organization or district admin, the Organization tab under Admin is where the org-level fields live — the things that apply to every member and every broadcast at your organization, not to one member's profile.
Open it from the directory hamburger → Admin home → Organization tab. Every change is audit-logged (who, what, and the optional reason you typed) so the trail is intact when the next admin takes over.
Identity
- Name — the public name of your organization. Shown in the directory header, in broadcast email FROM lines, and on every member's home screen.
- Short name — the squished version used in tight spaces (organization switcher dropdown, mobile chrome). For example, if your full name is “Maple Grove Elementary School,” the short name might be just “Maple Grove.”
- District — pick from the list. Drives the district-admin visibility scope; a district admin can manage every organization whose district matches their own. Pick Private if you're a stand-alone organization without a district umbrella.
- Type — elementary, middle, high, K-8, K-12, preschool, or foundation. This drives what filters (Classes vs. Grades vs. Cohorts), the grade options offered when adding a family, and whether Trusted Help is shown at all (foundations don't have a Trusted Help destination).
Address & phone
Optional. Used in the printed-directory header at the top of the page, and as the shipping address if you order a printed directory through Roost. Leave blank if you don't use a printed directory.
Logo
Square mark shown in the directory header and at the top of every broadcast email. PNG or JPG, ideally a square crop — non-square images get letterboxed onto a card background. Around 200×200 pixels is plenty; bigger files are auto-compressed on upload.
Default visibility for new members
This is the most consequential setting on the page. It decides what shows up the first time a new member signs in — before they pick anything themselves. Whatever you pick here applies only to members who haven't already chosen their own setting; existing members are never touched by a change here.
The three options, in the same words members see on their own Profile page:
- Visible to other members
New members start visible — their name shows in browse, search, class lists, and grade lists (where they apply). They still control which contact fields (email, phone, address) get shared, but the member card itself is on by default. This matches what existing members in section #1 of this page call “Visible.”
When to pick this: opt-out cultures — organizations whose paper directory traditionally went to every member by default, and where people expect to see and be seen.
Example A — start of year, admin imports the roster. The admin uploads a roster CSV under Roster. Every member on the roster is auto-listed in the directory at Visible. If a member wants out, they sign in, open Profile, and switch their setting to Private or Opt out. Until they do, they show up to the rest of the community.
Example B — new member joins mid-year. Someone joins the organization. An admin sends them an invite (or they submit the public signup form and the admin approves it). Once they sign in for the first time, they're Visible by default. If they want a different setting, they pick it on the spot.
- Private
New members can search and browse the directory themselves, but no one else can find them. They don't appear in browse, in search, or on class/grade lists. One-way visibility — they can reach out; nobody reaches in. This is the same “Private” option members can pick from their own Profile.
When to pick this: cultures where most members want to look up others but feel uncomfortable being looked up themselves until they actively opt in. Common when an organization is rolling out Roost for the first time and wants members to make a conscious visibility choice rather than land on a directory listing automatically.
Example. An organization enables Roost for the first time and sets the default to Private. New members sign in, see others they can look up, and choose for themselves whether to flip to Visible. Over the next few weeks the visible roster grows as people opt in — instead of the whole organization showing up the day Roost goes live.
- Opt out
New members start with no directory presence at all — they can't see other members, and other members can't see them. They're effectively outside the directory until they sign in and change the setting. This is the strictest default; rare in practice as an org-wide choice.
When to pick this: only if your organization has a hard policy that no directory presence may exist without explicit per-member opt-in (some independent schools or international schools fit this). For most organizations, Private is the better “strict default” — it still lets members see the community they joined.
Changing the default later is safe. Existing members keep whatever they picked. Only members who sign in after you save will land on the new default. So if you start at Visible and switch to Private three months in, members who already opted in stay opted in — only new arrivals get the stricter default.
16. For admins: managing families
Editing on behalf, lifecycle changes, splits and merges. Everything audit-logged.
The Families tab on /admin opens a browse view of every household at your school. Search by name or email, filter by Active / Moved / All. Click any guardian to open their detail page where you can edit on their behalf.
Editable per-person: first name, last name, preferred name, phone, public notes, show-email/phone toggles (narrowing only). All edits write an audit row. Sensitive fields (phone, contact toggles, any lifecycle action) require a free-text reason so the audit trail tells the story.
Lifecycle states — two distinct actions:
- Mark inactive — temporary, restorable. The person is hidden from directory and search but their sign-in still works (they land at an “away from an organization” screen with their Circles preserved). Use this when someone steps away temporarily.
- Mark moved (this school) — household has physically left your school's catchment. Removes their access at this school only; they keep any access at other schools they're still part of. Their student records preserve as historical so old class lists still resolve.
Family composition. Add a guardian to an existing family (sends a magic-link invite). Remove a guardian (soft-delete; kids stay). Split a family into two households for a divorce. Merge two families for a remarriage or duplicate cleanup. Delete a family — only for true duplicates; the UI will check for similar entries first and offer to move the kids to the surviving family before destroying anything.
PTO board members can't edit. They can see the same data admins see (for outreach), but every edit form is read-only or hidden. Editing from this surface is reserved for the school + district admin roles. The one thing that happens outside it: guardians can set their own children's grade and teacher from their Profile, which lands in the same audit log — so a change you didn't make may have come from the family themselves.
17. For admins: the school year — moving families up and between schools
Feeder schools, inviting next year's families early, the new-year roster, and end-of-year promotion. Most of this happens twice a year.
The seasonal roster work lives under one School year tab in /admin: Import roster, Promote & graduate, and Transfers. It's mostly done once in late spring (promotion/graduation) and once in the fall (the new roster).
Feeder schools
Under Organization → Feeder schools, you pick which other schools feed into yours — e.g. the elementaries whose top-grade students become your 6th graders. If a school splits between two destinations, mark the main one as primary. Feeders power the early-enrollment invites below and let you see where a transferring family is coming from.
Inviting rising students early
Before the official district roster lands, you can invite next year's incoming families to join early. From School year → Transfers → “Invite rising students from feeders”, Roost lists every family with a child in a feeder school's top grade — pre-selected based on where any older sibling already is — and you confirm who to invite.
It's an invite, not an automatic add: those parents already have a Roost account at their current school, so it's their call. Each family gets an email to join now or wait for the official roster — nothing happens until they accept. You track who hasn't decided under Transfers → Pending transfers, where you can send a reminder to one family or to everyone still outstanding, and cancel an invite. A reminder reuses the original link, so a parent who still has the first email keeps a working one; it goes to every adult on the invite rather than only the one it was addressed to; and it pushes the expiry back, so a late nudge is still worth sending.
The statuses you'll see
As families move between schools, a few labels appear on student cards:
- Rising — accepted an early-enrollment invite; listed at the new school for the coming year (and still at their current school) but not attending yet. The “starts next year” note now clears itself once the school year turns over, so a family is never told their child hasn't started when they have. To clear it sooner, use School year → Mark as started — no roster import needed.
- Awaiting next school — graduated out of your school toward a next school, but not yet enrolled there.
- Moved to [school] — graduated out and already enrolled at the next school (the early-enrollment case).
- Teacher assigned soon — promoted or activated for the new year, but the new roster hasn't assigned a homeroom teacher yet.
Rising / awaiting / moved students are hidden from regular members — only district/system admins and the child's own guardians see them until the new year starts.
Importing the new year's roster
On the import confirm step, tick “This is the start of a new school year” when the file is the official new-year roster — it activates any students who enrolled early (Rising → active). A routine mid-year update leaves that unchecked. Note: an import treats your file as the complete roster, so anyone not in it is queued for removal — if you're uploading a partial file, use Skip all removals.
Removals mark a student inactive — they are never deleted. A student who isn't in your file gets hidden from other families and from search, but their family links stay intact and they remain visible to their own parents and to you. If a partial file marked someone inactive by mistake, restore them from the family page; nothing was destroyed. Every deactivation is recorded in that student's history with the import named as the source.
Hand edits are not overwritten. If someone changed a kid's grade or teacher by hand since your last import — you fixing a mid-year move, or a guardian correcting their own child — and your file disagrees, the review step groups those rows, tells you who made the change and when, and keeps the hand edit. They start unchecked; tick one to let the file win. Same contract as rollover undo, which also reports a conflict rather than overwriting your edit.
Spelling differences won't create a second copy of a child. Because Roost matches students by name, a typo — your file says “Westley” where the directory says “Wesley” — would otherwise read as one new student and one student missing. Instead those rows are flagged, start unticked, and the matching child is never queued for removal. Nothing is created or deactivated until you say which it is. Sharing a guardian's email counts as a hint too, so a mistyped name in a family you already have is caught. Genuine siblings are unaffected.
Teachers are matched by name. A teacher column is applied when the name points at exactly one active teacher at your school — “Smith”, “Ms. Smith” and “Sarah Smith” all find the same person. When it's ambiguous (two teachers named Smith) or the name isn't on your teacher list, Roost won't guess: the homeroom is left alone and the row tells you why, so you can fix the file or set it by hand. Teachers who no longer work at the school are never matched.
End-of-year promotion & graduation
Promote & graduate moves everyone up a grade and graduates the top class out — preview before you commit, and you can undo. A student who already enrolled at their next school early is marked Moved to [school] (not “awaiting”) and still rolls their grade up with everyone else. Each school controls its own roster: nothing the next school does removes a student from yours until you graduate them out.
18. For admins: importing the roster
What the importer does with your file, and what to check before you finish. You do this once or twice a year.
You upload a spreadsheet, Roost shows you exactly what it plans to do, and nothing is saved until you approve it. If the review screen looks wrong, close it and upload a corrected file — you can't break anything by uploading.
One row per child, not per family
Give each child their own row. A family with three kids is three rows, and each row repeats the same parent details.
Roost groups those rows into families by parent email address, not by home address. Address would be the obvious choice and it's the wrong one: it splits families who typed their address slightly differently on two forms, and it merges unrelated families in the same apartment building. Email is the thing people type consistently.
So when the review screen says something like “312 rows became 198 families”, that's the sibling grouping working. If that second number looks too high, the usual cause is one parent's email spelled two different ways in the source file.
Families already on Roost
A family already here doesn't get a second copy — their existing household is reused, and a new sibling is added to it. Their privacy choices, logins, and history all stay.
Occasionally you'll see a flag saying two guardians on one row are currently in two different households. That usually means separated parents who each have their own household on Roost, and the school's file still lists them together. Roost won't merge them on its own, because merging two real households is not something to guess at. Leave it and sort it out afterward under Families.
Grades have to be written a way Roost understands
Roost reads PK, K, and 1 through 12. It's forgiving about format — 9, 09, 9th, 9th Grade, and Kindergarten all work.
What it can't read is a grade written as a word or a year: Freshman, Sophomore, Class of 2029. High-school exports are the usual source of these.
For a child already on Roost, an unreadable grade is skipped and their current grade is left alone. For a new child it stops that row, and Roost names them on the review screen — something like “Row 48: Sam Rivera is new and their grade ‘Freshman’ wasn't recognized… they were not added.” Fix the grade column and upload again. Nobody is dropped quietly; you will see them listed.
Two parents per row
The file carries up to two guardians per child, which is what school exports provide. A third guardian — a grandparent, a stepparent, a nanny — is added by hand afterward from the family's page, and there's no limit once they're here. Re-importing later won't remove the ones you added.
Whether imported families are visible right away
This is the setting with the biggest consequences, and it's decided before you import, under Organization.
- At a visible-by-default school, imported families appear in the directory as soon as you finish, and each family can hide themselves later.
- At a private-by-default school, imported families are in the system but nobody can see them until each family signs in and chooses to be listed. A quiet directory after a successful import usually means this, not a failed import.
Check which one you are before importing several hundred families, not after.
Children missing from the file
A child who is on Roost but absent from your new file is treated as having left. They're marked inactive, not deleted: they drop out of the directory and class lists, but their record and their family links stay, and you can restore them in one click from the family's page.
The review screen lists every child this would affect, and you can uncheck any of them. Worth reading that list rather than skimming it — a child missing from the file because of a spreadsheet filter looks identical to one who actually moved away.
The reverse is handled too: if a child you previously marked inactive shows up in a new file, they're restored rather than duplicated.
The “start of a new school year” option
Choose this when the file is next year's roster rather than a mid-year correction. It switches on the students who've been waiting to start, so families who joined early stop being labeled as not yet attending.
It also offers a second, separate choice: reset returning families' privacy choices. That one is off unless you turn it on, and it asks every returning family to decide again whether to be listed. Some schools want that fresh consent each year; most don't. Leaving it off keeps everyone's existing choices.
At a brand-new school this option does nothing useful — there are no returning families and nobody waiting to start.
If a child is changing schools
Order matters. The school the child is leaving should finish its end-of-year promotion first; then the school they're joining imports. Done the other way round, the child is briefly enrolled at both schools and appears in two directories.
If you're only running one school, this doesn't apply to you.
What to check before you approve
- The family count looks about right for your school — not roughly double, which means the grouping didn't catch siblings.
- You've read the error list, if there is one. Those rows are not being imported.
- The list of children being marked inactive contains only children who really left.
- The new-family count is plausible for the time of year.
None of it is permanent in the sense of being unfixable — inactive children restore, families merge and split — but reading the review screen carefully is much faster than repairing afterward.