Repository navigation
Description
Background
We're adding two scoped workspace roles, Approve-only and Guest. Today an admin only finds them by opening the role selector for a specific member, so it's easy to not realize they exist. so most admins
We want admins to learn about the new roles where they already assign roles, without adding another pop-up or modal. We also want to hear which other scoped roles customers need.
This issue adds a New roles badge to the Members item in the workspace menu, a promo banner to the top of the Members page, and a grouped, annotated role selector with New badges and a feedback link. It changes how roles are presented only; no role's permissions change.
Product and design details
Applicability
We show every element in this issue to workspace admins who can change other members' roles, on any workspace where Approve-only and Guest can be assigned. Admins who can't change roles see none of it.
Members item in the workspace menu
Workspace menu with New roles badge on Members
- We add a
New rolesbadge to the right ofMembersin the workspace menu (LHN on wide layouts, the workspace menu list on narrow layouts). - The badge reads
New roles, notNew, so admins don't read it as "new members." - We reuse the existing badge component used elsewhere in the LHN; no new component.
- The badge hides once the admin dismisses the banner below. See Dismissal.
Banner on the Members page
Members page with default promo banner
- We add a banner at the top of the
Memberspage, aboveTotal workspace members. - We reuse the existing default promo banner (icon, title, supporting copy, close button); no new banner style.
- Title:
New roles available - Supporting copy:
Give members just the access they need with new Approve-only and Guest roles., withApprove-onlyandGuestin bold. - Clicking the
×dismisses the banner. See Dismissal. - We don't add a badge or tooltip to the
Rolecolumn header.
Role selector RHP
Role RHP, grouped and alphabetical
Header copy, above the list:
Assign a role to manage a member's workspace permissions. Compare workspace roles.Compare workspace rolesis a link that opens Managing Workspace Members in a new tab.
The list is split into two groups, each with a small group label, and a divider between them. Within each group, roles are in alphabetical order:
Admin rolesCard admin:Manage workspace cardsPayments admin:Manage workflow paymentsPeople admin:Manage members and approval workflowsWorkspace admin:Manage reports and workspace settings
Other rolesApprove-onlywith aNewbadge:Approve reports onlyAuditor:View and comment on reportsGuestwith aNewbadge:Submit reports with limited visibilityMember:Submit and approve reports
Footer, centered above Save:
Not seeing the role you need? Let us know.Let us knowopens a Concierge chat so the admin can describe the role they need.
The grouping, order, and header copy are permanent. Only the New badges are temporary.
Dismissal
- Dismissing the banner is saved per admin, not per workspace, so an admin with several workspaces dismisses it once.
- When the admin dismisses the banner, the
New rolesbadge onMembersalso hides. - The
Newbadges in the role selector stay until the promotion ends, independent of the banner. - We stop showing the banner, the
New rolesbadge, and theNewrole badges for everyone 90 days after the roles launch.
Issue Owner
Current Issue Owner: @Krishna2323Metadata
Metadata
Labels
Type
Projects
- StatusShow more project fieldsNo status
Activity
JmillsExpensify commentedon Nov 3, 2026
@JS00001 any feedback on this dismissal logic? Maybe it's not worth it, and we just show thisfor 60 days and then remove it. Could be a more simple approach?
JS00001 commentedon Nov 3, 2026
@JmillsExpensify I see a few approaches we could take here:
Tbh it seems simpler to have krishna create the badges, and then create a PR to remove the badges at the same time. Then in roughly 90 days, we can merge the follow up PR to remove the badges
JmillsExpensify commentedon Nov 3, 2026
That's cool with me. I can create an issue to remove them in that timeframe. Down to simplify.
JS00001 commentedon Nov 3, 2026
Sounds good, I have a Pr to add the nvp, @Krishna2323 it'll be for
DismissProductTrainingwith namenewWorkspaceRolesBannerJmillsExpensify commentedon Nov 3, 2026
Thanks. Added @daledah for any reviews as well
2 remaining items
stephanieelliott commentedon Nov 6, 2026
👋 sorry for the late add, but @daledah can we update the
compare workspace roleslink to use this instead: https://help.expensify.com/articles/new-expensify/workspaces/Understand-Workspace-Roles-and-PermissionsNote that the URL is not live yet, but it will be as soon as this is merged #106171
daledah commentedon Nov 6, 2026
@Krishna2323 could you please check this comment?
shawnborton commentedon Nov 6, 2026
@Krishna2323 check here!
Krishna2323 commentedon Nov 10, 2026
PR is merged!
melvin-bot commentedon Nov 11, 2026
If you are the assigned CME please investigate whether the linked PR caused a regression and leave a comment with the results.
If a regression has occurred and you are the assigned CM follow the instructions here.
If this regression could have been avoided please consider also proposing a recommendation to the PR checklist so that we can avoid it in the future.
Chandkia24 commentedon Nov 11, 2026
Deploy Blocker #106589 was identified to be related to the PR #106052 that attempted to fix this issue.
daledah commentedon Nov 11, 2026
not a blocker because the documentation PR remains open and unmerged
jponikarchuk commentedon Nov 11, 2026
Deploy Blocker #106606 was identified to be related to the PR #106052 that attempted to fix this issue.
stephanieelliott commentedon Nov 11, 2026
Cross-posting from Slack -- no need to block on this, it's being addressed here: https://expensify.slack.com/archives/C01GTK53T8Q/p1794427377024229?thread_ts=1794362359.913849&cid=C01GTK53T8Q
[-]Promote the new `Approve-only` and `Guest` workspace roles on the `Members` page and role selector[/-][+][Due for payment 2026-11-19] Promote the new `Approve-only` and `Guest` workspace roles on the `Members` page and role selector[/+]melvin-bot commentedon Nov 12, 2026
@Krishna2323 / @daledah
The solution for this issue has been 🚀 deployed to production 🚀 in version 9.5.36-0 and is now subject to a 7-day regression period 📆. Here is the list of pull requests that resolve this issue:
If no regressions arise, payment will be issued on 2026-11-19. 🎊
The following checklist (instructions) will need to be completed before the issue can be closed. Please copy/paste the Contributor+ Checklist from here into a new comment on this GH and complete it. If you have the K2 extension, you can simply click: [this button]. If no checklist is needed for this issue, you can click: [no checklist button]