Skip to content

Organization & Team

Managing your organization settings ensures your workspace accurately represents your brand and equips team members with appropriate role-based access permissions.

From editing your organization name to inviting collaborators with Role-Based Access Control (RBAC), organization settings keep your team aligned and your short links secure.


1. Organization Profile

Your organization profile defines the identity of your workspace:

  • Organization Name: The commercial name of your business or team displayed across the application and generated assets.
  • Slug: A unique URL-friendly identifier assigned to your organization.

To update your organization name, navigate to Settings > Organization, edit the name, and click Save Changes.


2. Platform Roles & Permissions

Ruby provides four distinct user roles to support team collaboration while protecting account security and access control:

Role Access Level & Key Responsibilities
Owner Full administrative and legal access. Has complete authority over the organization, including member invitations, role assignments, API keys, organization deletion, and account ownership transfer. Only one member can be the active Owner.
Admin Full operational access. Can configure organization profile details, invite team members, assign Editor/Viewer roles, generate developer API keys, and manage all links and link groups. Cannot transfer ownership or delete the organization.
Editor Marketing and operations access. Can create, edit, deactivate, and export links and link groups, upload bulk CSV files of up to 100,000 links, build UTM tags, and view analytics. Cannot modify organization settings, manage team members, or generate API keys.
Viewer Read-only access. Can inspect links, view link groups, and monitor click analytics. Cannot create, edit, or delete resources, and cannot access workspace settings.

3. Team Members & Invitations

The Team Members section lists all active users and pending invitations in your organization.

Inviting a New Team Member

To invite a colleague to your organization:

  1. In Settings > Organization, navigate to the Team Members section.
  2. Click Invite Member.
  3. Enter your colleague's Email Address.
  4. Select their platform role (Admin, Editor, or Viewer).
  5. Click Send Invitation.

The recipient will receive an invitation email with an activation link. If they already have an existing Ruby account, the invitation will also appear under Account Settings in Pending Invitations.

Managing Active Members

Owners and Admins can manage existing team members using the action menu next to each user:

  • Change Role: Adjust a team member's role to grant or restrict capabilities.
  • Remove Member: Immediately revokes the user's access to the organization. Their personal Ruby user account remains intact, but they can no longer access your workspace.
  • Transfer Ownership: Available exclusively to the current Owner. Allows transferring organization ownership to an existing active team member. Upon confirmation, the previous owner is reassigned to an Admin role.

Managing Pending Invitations

Invitations that have not yet been accepted appear in the members list marked as Invited:

  • Resend Invitation: Dispatches a new invitation email with a fresh link.
  • Revoke Invitation: Immediately cancels the pending invitation link.