How to Update Organization Settings
This guide explains how Organization Administrators can edit key profile information for their organization, such as the name, description, website, and industry. Organization settings control how your organization appears to members and provide essential context for your team's collaborative workspace.
Required Permissions: You must have the OrgAdmin role to modify organization settings. Only Organization Administrators can access and edit these configuration options.
To learn more about permissions, see the Managing Role Permissions guide.
Organization Settings Interface
The Organization Settings page provides in-place editing capabilities for key organizational information. This interface allows authorized administrators to update profile details directly without complex forms or workflows.
1. Accessing Organization Settings
Navigate to the organization settings interface through multiple access paths:
- Main Sidebar: Click "Organization" → "Settings" from the primary navigation menu.
- Direct URL: Go directly to the settings page at https://safedevops.app/organizations/org-settings.
- Quick Access: Use the organization dropdown in the top navigation bar and select "Settings".
- Permission Verification: Ensure you have OrgAdmin privileges to access all editing capabilities.
[Screenshot showing the navigation path to organization settings.]
2. Editing Organization Details
The interface provides in-place editing for key organizational information:
- Organization Name: Click the name field to edit your organization's display name.
- Description: Update the organizational description to reflect your team's mission and purpose.
- Website URL: Add or modify your organization's website link for external reference.
- Industry Classification: Select the appropriate industry category for your organization.
- Visual Feedback: Fields become highlighted and editable when clicked, providing clear visual cues.
[Screenshot showing a field in edit mode with highlighted input and save button visible.]
3. Saving and Confirming Changes
Complete the editing process with proper validation and confirmation:
- Save Button: Click the "Save" button that appears when editing any field to apply your changes.
- Validation: The system validates inputs to ensure data integrity and format compliance.
- Confirmation: Receive immediate feedback confirming successful updates.
- Error Handling: Address any validation errors with clear guidance on corrections needed.
- Auto-Save: Some changes may be automatically saved for improved user experience.
Understanding Read-Only Information
The organization settings page displays both editable and read-only information to provide comprehensive organizational context while maintaining data integrity for system-managed fields.
Member Count and Usage Limits
Monitor your organization's user capacity and subscription limits:
- Current Usage: View your active member count compared to your plan's maximum (e.g., "9 / 50 users").
- Plan Limits: Understand restrictions based on your current subscription tier.
- Capacity Planning: Monitor usage to plan for subscription upgrades when approaching limits.
- Billing Integration: Member count directly impacts billing calculations for user-based pricing.
Subscription Management: To modify user limits or upgrade your plan, visit the Billing and Subscription section.
Organization Creation Date
Track your organization's history and tenure on the platform:
- Join Date: Shows when the organization was originally created on the Safedevops.app platform.
- Historical Context: Provides context for organizational maturity and experience with the platform.
- Audit Trail: Serves as part of the organization's audit and compliance history.
- Read-Only Status: This information cannot be modified as it represents historical fact.
Best Practices for Organization Settings
Follow these recommendations to maintain effective organizational information that supports collaboration and professional presentation.
Organizational Information Guidelines
Maintain professional and accurate organizational details:
- Clear Naming: Use descriptive, professional organization names that clearly identify your team or company.
- Comprehensive Descriptions: Provide detailed descriptions that explain your organization's purpose and scope.
- Updated Contact Information: Keep website URLs current and ensure they link to active, relevant pages.
- Accurate Industry Classification: Select industry categories that accurately reflect your organization's primary business focus.
- Regular Reviews: Periodically review and update organizational information to reflect any changes.
Security and Compliance Considerations
Maintain appropriate security practices when managing organizational settings:
- Access Control: Ensure only authorized OrgAdmin users can modify organizational settings.
- Change Documentation: Keep records of who makes changes and when for audit purposes.
- Information Sensitivity: Be mindful of what organizational information is shared and visible to members.
- Compliance Requirements: Ensure organizational information meets any industry-specific compliance standards.