Getting Started with Organizations
Create your first Organization and start collaborating on RubyGems.org in minutes.
Before You Begin
To create an organization, you’ll need:
- A RubyGems.org account with multi-factor authentication (MFA) enabled
- At least one gem where you’re listed as an owner
Creating Your Organization
Navigate to your dashboard and click Create Organization.
Step 1: Set Organization Details
Provide your Organization’s information:
- Handle: Your unique identifier (selected from a list of gems the current user is listed as an owner of)
- Display Name: How your Organization appears publicly (2-255 characters)
The handle becomes part of your organization URL: rubygems.org/organizations/your-handle
Step 2: Select Gems to Transfer
If you own multiple gems, choose which ones to transfer to the Organization:
- Only gems where you’re an owner appear in the list
- Gems already belonging to other organizations are excluded
- You can transfer additional gems later
Important: Once transferred, gems belong to the Organization. Individual ownership is replaced by organization membership.
Step 3: Invite Team Members
Add your collaborators to the Organization:
Automatic Suggestions: We’ll suggest users who co-own your selected gems. This makes it easy to maintain existing collaborations.
Assign Roles: Choose the appropriate role for each member:
- Owner: Full organization control
- Admin: Gem and member management
- Maintainer: Basic access and gem operations
- Outside Collaborator: Limited access, retains personal ownership of gems and is not a member of the orgnization
Step 4: Confirm and Create
Review your organization setup:
- Organization name and handle
- Selected gems for transfer
- Invited members and their roles
Click Create Organization to finalize your Organization. You’ll see:
- Your Organization is created
- Selected gems are transferred
- Members receive an email to join your Organization.
- You’re redirected to your organization page
After Creation
Immediate Next Steps
- Wait for Invitations: Members must accept their invitations to join the Organization
- Configure Settings: Visit organization settings to customize further
- Transfer More Gems: Add additional gems as needed
Managing Your Organization
Access your Organization at rubygems.org/organizations/your-handle to:
- View organization gems
- Manage members
- Update settings
- Monitor activity
API and Automation
Currently, onboarding an Organization must be done through the web interface. API support may be added in future.
Troubleshooting
Can’t Create Organization?
- Verify MFA is enabled on your account
- Ensure you own at least one gem (for gem-based organizations)
- Check that your desired handle isn’t already taken
Invitation Issues?
- Invitations expire after a set period
- Members must have RubyGems.org accounts
- Check spam folders for invitation emails
Need More Help?
- Review our Roles and Permissions guide
- Learn about Managing Members
- Contact support@rubygems.org for assistance
Ready to collaborate? Create your Organization now.