​
Overview

Organization Settings allow administrators to configure company details, customize branding (Enterprise tier), and manage organization metadata. Access at /admin/settings.
Access Required: Admin or Owner role

​
Organization Details

​
Basic Information

​
Organization Name
string
required
Your company or organization name (displays across platform)
​
Slug
string
required
URL-friendly identifier (used in web addresses)Format: lowercase, hyphens allowedExample: ripplecore-uk
​
Logo URL
url
Public URL to your organization logo (displayed in navigation)Recommended: 200x200px PNG or SVG with transparent background

​
Example Configuration

{
  "name": "RippleCore UK",
  "slug": "ripplecore-uk",
  "logoUrl": "https://cdn.ripplecore.co.uk/logo.png"
}

​
License Information

​
Current Tier Display

Shows read-only license details:
  • Tier: Starter | Growth | Enterprise
  • Max Users: Tier capacity
  • Active Users: Current usage (24h window)
  • Status Badge: Color-coded based on usage

​
Tier Upgrade

Buttons displayed for tier advancement:
Current TierAvailable Upgrades
Starter (50 users)Growth, Enterprise
Growth (500 users)Enterprise
EnterpriseNone (unlimited)
Upgrade Process:
  1. Click “Upgrade to [Tier]” button
  2. Contact sales (automated in Phase 2)
  3. Billing adjustment immediate
  4. Features unlock automatically

​
Metadata Configuration

Organization metadata used for analytics segmentation and benchmarking.

​
Industry

Select your organization’s primary industry:
​
Technology
​
Healthcare
​
Finance
​
Education
​
Manufacturing
​
Retail
​
Non-Profit
​
Other
Purpose: Industry benchmarking and comparative analytics

​
Organization Size

Select headcount range:
​
1-49 employees
Small Business
​
50-199 employees
Medium Business
​
200-999 employees
Large Business
​
1000-4999 employees
Enterprise
​
5000+ employees
Large Enterprise
Purpose: Size-based feature recommendations and pricing

​
Country

Select primary operating country:
​
United Kingdom
​
United States
​
France
​
Germany
​
Spain
​
Netherlands
​
Ireland
​
Other
Purpose: Compliance framework mapping (CSRD, UK Social Value Act, etc.)

​
Timezone

Select organization’s default timezone:
​
UTC (GMT+0)
​
Europe/London (GMT+0/+1)
​
Europe/Paris (GMT+1/+2)
​
America/New_York (GMT-5/-4)
​
America/Los_Angeles (GMT-8/-7)
​
Asia/Tokyo (GMT+9)
Purpose: Survey scheduling, reporting timestamps, analytics windows

​
Branding Customization

Enterprise Tier Only - Branding features require Enterprise license

​
Custom Brand Color

Feature: Replace default purple (#0d1594) with your brand color Requirements:
  • Enterprise tier active
  • Valid hex color code
  • Contrast ratio ≥ 4.5:1 for accessibility
Example: 
Primary Color: #1a73e8 (Google Blue)
Applied to: Buttons, links, accents, navigation

​
Custom Domain

Feature: Use your own domain (e.g., impact.yourcompany.com) Requirements:
  • Enterprise tier active
  • DNS CNAME record configuration
  • SSL certificate (auto-provisioned via Let’s Encrypt)
Setup Process:
  1. Add CNAME record: impact.yourcompany.com → app.ripplecore.co.uk
  2. Enter domain in settings
  3. Verify DNS propagation
  4. SSL certificate auto-issues (24-48h)

​
White-Label Capabilities

Enterprise Features:
  • Remove “Powered by RippleCore” branding
  • Custom email templates with your branding
  • Custom logo in all evidence exports
  • Branded PDF reports
Upgrade Benefits: 
Standard: RippleCore branding + your logo
Enterprise: 100% your branding, zero RippleCore mentions

​
Danger Zone

​
Delete Organization

Permanent Action - Cannot be undone. All data will be deleted.
What Gets Deleted:
  • ❌ All evidence data (kindness, volunteer, donations, wellbeing)
  • ❌ All user accounts and sessions
  • ❌ All analytics and reports
  • ❌ License and billing records
  • ❌ Organization settings and metadata
What Remains:
  • ✅ Audit trail (for legal compliance)
  • ✅ Billing history (for accounting)
Confirmation Required: Type organization name to confirm deletion Recommended Instead:
  • Downgrade to Starter tier to reduce costs
  • Deactivate inactive users
  • Export data before deletion

​
API Integration

​
Get Organization Settings

GET /api/admin/settings
Response: 
{
  "data": {
    "id": "org_abc123",
    "name": "RippleCore UK",
    "slug": "ripplecore-uk",
    "logoUrl": "https://cdn.ripplecore.co.uk/logo.png",
    "tier": "enterprise",
    "maxUsers": 999999,
    "activeUsers": 342,
    "metadata": {
      "industry": "technology",
      "size": "200-999",
      "country": "united_kingdom",
      "timezone": "Europe/London"
    },
    "branding": {
      "primaryColor": "#0d1594",
      "customDomain": "impact.ripplecore.co.uk",
      "whiteLabel": true
    }
  }
}

​
Update Settings

PATCH /api/admin/settings
{
  "name": "Updated Company Name",
  "metadata": {
    "industry": "healthcare",
    "size": "50-199"
  }
}

​
Best Practices

​
Logo Requirements

Recommended Specs:
  • Format: PNG or SVG
  • Size: 200x200px (square)
  • Background: Transparent
  • Max file size: 500KB
Hosting Options:
  • Vercel Blob Storage (built-in)
  • Cloudinary
  • AWS S3
  • Your CDN

​
Metadata Accuracy

Keep metadata up-to-date for:
  • Accurate benchmarking
  • Relevant compliance frameworks
  • Industry-specific features
  • Size-appropriate pricing

​
Update Frequency

Review quarterly:
  • Organization name changes (rebrands)
  • Size category (headcount growth)
  • Industry shifts (business pivot)
Review annually:
  • Logo refresh
  • Branding guidelines
  • Custom domain needs

​
Common Scenarios

​
Rebranding

Situation: Company undergoes rebrand with new name and logo Action:
  1. Update organization name
  2. Upload new logo URL
  3. Update slug if needed (impacts URLs)
  4. Test across all evidence modules
  5. Notify users of rebrand

​
Enterprise Upgrade

Situation: Upgrading from Growth to Enterprise for white-label Action:
  1. Click “Upgrade to Enterprise”
  2. Configure custom brand color
  3. Set up custom domain (DNS)
  4. Enable white-label features
  5. Update email templates

​
Multi-Region Expansion

Situation: Expanding from UK to US operations Action:
  1. Keep primary country as headquarters
  2. Use UTC timezone for global consistency
  3. Configure compliance frameworks for both regions
  4. Consider separate organizations for regional isolation

​
Troubleshooting

Causes:
  • Invalid URL
  • CORS restrictions
  • Image file too large
Solutions:
  • Verify URL is publicly accessible
  • Use recommended hosting (Vercel Blob)
  • Compress image to under 500KB
Cause: DNS propagation delaySolution: Wait 24-48h for DNS changes to propagate globally. Verify CNAME record with dig or online DNS checker.
Cause: Enterprise tier requiredSolution: Upgrade to Enterprise tier to unlock branding customization.
Cause: Safety confirmation requiredSolution: Type exact organization name to confirm deletion. Contact support if stuck.

​
Enterprise Branding Examples

​
Technology Company

{
  "branding": {
    "primaryColor": "#1a73e8",
    "customDomain": "impact.techcorp.com",
    "whiteLabel": true
  }
}

​
Healthcare Provider

{
  "branding": {
    "primaryColor": "#00796b",
    "customDomain": "wellness.hospital.nhs.uk",
    "whiteLabel": true
  }
}

​
Non-Profit Organization

{
  "branding": {
    "primaryColor": "#d32f2f",
    "customDomain": "impact.charity.org",
    "whiteLabel": true
  }
}

​
Next Steps

License Management

Monitor usage and upgrade tiers

User Management

Manage organization members
Need Help? Contact support@ripplecore.co.uk for settings configuration or Enterprise upgrades.