Organizations

Manage teams, invite members, and collaborate in shared workspaces

Organizations in Ryva are collaborative workspaces where teams can work together on projects. Each organization has its own plan, settings, members, and resources.

Understanding Organizations

An organization (also called a workspace) is a shared environment where:

• Team members collaborate on projects
• Resources and storage are pooled
• Billing and subscriptions are managed
• Permissions and roles are controlled

Every user can be a member of multiple organizations. You can easily switch between organizations using the workspace switcher in the sidebar.

Creating an Organization

Users can create up to 10 organizations per account.

1. Navigate to Create

   From your dashboard, click the workspace switcher and select “Create Organization” or complete the onboarding flow.

2. Enter Organization Details

   Provide:

   • Organization name (3-100 characters) - e.g., “Acme Inc.”
   • Plan selection - Choose from Free, Team, or Enterprise

   The system automatically generates a unique subdomain slug from the organization name for paid plans.

3. Organization Created

   You’re automatically set as the owner and the organization becomes your active workspace.

Subdomains are automatically generated for Team and Enterprise plans. The slug is derived from your organization name and must be unique across the platform.

Organization Plans

Ryva offers three organization tiers:

Free Plan

• Basic features for individuals
• Limited storage and resources
• No custom subdomain
• Perfect for personal projects

Team Plan

• Custom subdomain (e.g., acme.ryva.app)
• Increased storage (100GB)
• Advanced collaboration features
• Priority support
• Team analytics

Enterprise Plan

• Everything in Team
• Custom integrations
• Dedicated support
• Advanced security features
• Custom SLA

You can upgrade or downgrade your organization plan at any time from the billing settings. Plan changes are prorated.

Team Management

Inviting Members

Organization owners and admins can invite new team members:

1. Open Invite Dialog

   Navigate to Settings → Organizations → [Your Organization] and click “Invite Member.”

2. Enter Member Details

   Provide:

   • Email address - The invitee’s email
   • Role - Member, Admin, or Owner
3. Send Invitation

   The system sends an email invitation to the recipient. Invitations expire after a set period.

Only organization owners can invite other owners. Be careful when assigning owner roles as owners have full control over the organization, including billing and deletion.

Member Roles

Ryva uses a role-based access control system:

Role	Permissions
Owner	Full control including billing, member management, and organization deletion. The user who created the organization.
Admin	Manage members, projects, and settings. Cannot manage billing or delete the organization.
Member	Access projects and collaborate. Limited administrative permissions.

An organization must always have at least one owner. Ownership can be transferred but cannot be completely removed.

Managing Invitations

For Inviters

View and manage pending invitations:

• See all sent invitations
• Check invitation status
• Resend or cancel invitations
• View expiration dates

For Invitees

Users who receive invitations can:

1. Check Email

   Receive an invitation email with organization details and the inviter’s information.

2. Review Invitation

   View pending invitations in the user dashboard or click the email link.

3. Accept or Decline

   • Accept - Join the organization with the assigned role
   • Decline - Reject the invitation

You can view all your pending invitations from multiple organizations in one place from your dashboard.

Organization Settings

Updating Organization Details

Owners and admins can update:

• Organization name - Change the display name
• Settings - Custom configuration stored as JSON

Subdomain slugs cannot be changed after organization creation. This ensures consistency and prevents broken links.

Organization Deletion

Only organization owners can delete an organization:

1. Navigate to Settings

   Go to Settings → Organizations → [Your Organization] → Danger Zone

2. Confirm Deletion

   This action is irreversible. All projects, data, and member associations will be permanently deleted.

Switching Organizations

Users can belong to multiple organizations and switch between them:

1. Click the workspace switcher in the sidebar
2. Select the organization you want to activate
3. The dashboard updates to show the selected organization’s data

Your active organization is saved locally. When you return to Ryva, you’ll see the last organization you were working in.

Best Practices

Use descriptive organization names

Choose clear, meaningful names that team members will recognize. The organization name is used to generate the subdomain for paid plans.

Assign appropriate roles

• Use Member role for most team members
• Reserve Admin for team leads who need to manage projects
• Only assign Owner to trusted individuals who need billing access

Review members regularly

Periodically audit your organization members and remove users who no longer need access.

Start with Free, upgrade when needed

Begin with the Free plan to test the platform. Upgrade to Team when you need advanced features or custom subdomains.

Communicate plan changes

Notify team members before upgrading or downgrading plans, as features and limits may change.

Limits and Quotas

Organization Limits

• Maximum 10 organizations per user account
• Organization names must be 3-100 characters
• Subdomain slugs are automatically generated and cannot exceed 63 characters

Reserved Subdomains

Certain subdomains are reserved and cannot be used:

• System subdomains (api, app, www, admin, etc.)
• Common terms that could cause confusion

If your desired subdomain is taken, the system automatically appends a numeric suffix (e.g., acme-2, acme-3) when creating the organization.

Invitation System

Invitation Lifecycle

1. Sent - Invitation created and email sent
2. Pending - Waiting for recipient response
3. Accepted - User joined the organization
4. Declined - User rejected the invitation
5. Expired - Invitation exceeded time limit

Email Notifications

Invitations trigger automatic email notifications containing:

• Organization name and details
• Inviter’s name and avatar
• Role being offered
• Accept/decline links
• Expiration date

Troubleshooting

Can’t create organization?

• Verify you haven’t reached the 10-organization limit
• Ensure the organization name meets length requirements (3-100 characters)
• Check that the generated subdomain isn’t reserved or taken

Subdomain already taken?

The system automatically appends a number to make it unique. Try a more specific organization name for a cleaner subdomain.

Invitation not received?

• Check spam/junk folder
• Verify the email address is correct
• Resend the invitation from the pending invitations page

Can’t remove a member?

Ensure you have the appropriate permissions (Owner or Admin role required to manage members).