Imported from docs/user-guides/admin-platform/settings.md in cloud-factory. Last synced: 2026-03-15
Settings
The Settings area is where you configure your profile, team, branding, security, and platform-wide preferences. Access it by clicking Settings in the sidebar.
General
User Profile
Manage your personal account information.
- Navigate to Settings > General.
- Edit your display name, email, or avatar.
- Click Save Changes.
Your display name appears in the audit log, ticket responses, and team member lists, so keep it professional and recognizable.
Branding
Logo Upload
Customize the platform appearance with your organization's branding.
- Navigate to Settings > Branding.
- Click Upload Logo in the logo section.
- Select an image file (PNG or SVG, recommended size: 200x50px).
- Preview the logo in the header.
- Click Save.
The logo appears in the sidebar header, email templates, and customer-facing invoices.
Email Appearance
Customize how outbound emails look to your customers.
- Navigate to Settings > Branding (or Email Branding in the sidebar).
- Configure:
- Header logo
- Brand colors (primary, secondary)
- Footer text and links
- Preview the email template.
- Click Save.
Changes apply to all future outbound emails (invoices, notifications, support replies).
Tenant Settings
Currency
- Navigate to Settings > Tenant.
- Select your preferred currency from the dropdown.
- Click Save.
The currency setting affects how prices are displayed across the platform and on customer invoices. Changing the currency does not convert existing prices -- you will need to update product pricing manually.
Timezone
- Navigate to Settings > Tenant.
- Select your timezone.
- Click Save.
The timezone affects:
- Timestamps displayed in the interface
- SLA calculations for support tickets
- Scheduled report generation
- Invoice due date calculations
Team Members
See User Management for detailed instructions on:
- Inviting new team members
- Assigning and changing roles
- Removing team members
Security
Two-Factor Authentication (2FA)
- Navigate to Settings > Security.
- Click Enable Two-Factor Authentication.
- Follow the setup wizard (scan QR code, verify with TOTP code).
- Store backup codes securely.
See User Management for the full 2FA setup procedure.
Password
- Navigate to Settings > Security.
- Click Change Password.
- Enter your current password, then enter and confirm the new one.
- Click Update Password.
Sessions
View and manage your active login sessions.
- Navigate to Settings > Security.
- The active sessions list shows each session with:
- Device type and browser
- IP address
- Last active timestamp
- Click Terminate next to any session you do not recognize.
API Keys
Manage API keys for external integrations.
- Navigate to Settings > API Keys.
- View existing keys with their names, creation dates, and last-used timestamps.
- Create new keys or revoke existing ones.
See User Management for detailed API key management instructions.
Notification Preferences
Configure which events trigger notifications and how they are delivered.
- Navigate to Settings > Notifications.
- Toggle notifications for each event category:
| Event Category | Description |
|---|---|
| New Orders | When a customer places a new order |
| Provisioning Updates | When resources are provisioned or fail |
| Payment Received | When an invoice is paid |
| SLA Breaches | When a support ticket breaches its SLA |
| System Alerts | Infrastructure health warnings |
| Security Events | Login attempts, permission changes |
- For each category, choose delivery method: In-App, Email, or Both.
- Click Save Preferences.
Email Templates
Customize the content of automated emails sent to customers.
- Navigate to Email Templates in the sidebar (or Settings > Email Templates).
- Select a template to edit:
- Welcome email
- Order confirmation
- Invoice sent
- Payment received
- Password reset
- Support ticket updates
- Edit the subject line and body content.
- Use the available template variables (e.g.,
\{\{customer_name\}\},\{\{order_id\}\},\{\{amount\}\}). - Preview the rendered email.
- Click Save Template.
Tip: Always preview templates after editing to verify that variables render correctly and the layout looks professional.
Email Branding
Separate from individual templates, email branding controls the visual wrapper around all outbound emails.
- Navigate to Email Branding in the sidebar.
- Configure the header (logo, background color).
- Configure the footer (company address, social links, unsubscribe text).
- Preview with a sample email.
- Click Save.
DNS Zone Management
Manage DNS zones for customer domains and platform services.
- Navigate to DNS in the sidebar.
- View existing DNS zones and their records.
- To add a new zone:
- Click Add Zone.
- Enter the domain name.
- Configure the required DNS records (A, AAAA, CNAME, MX, TXT).
- Click Save.
- To edit an existing zone, click the zone name and modify records as needed.
Compliance Settings
GDPR
Configure data protection and privacy settings.
- Navigate to Settings > Compliance.
- Review and configure:
- Data retention periods
- Consent management settings
- Privacy policy URL
- Data processing agreement (DPA) link
Data Export
For GDPR data subject access requests:
- Navigate to Settings > Compliance > Data Export.
- Enter the customer email or tenant ID.
- Click Generate Export.
- The system compiles all data associated with that customer.
- Download the export package when ready.
Note: Data exports may take several minutes for customers with extensive history.
Roles Management
Create and manage custom roles beyond the default four (Admin, Manager, Support, Billing).
- Navigate to Settings > Roles.
- View existing roles and their permission sets.
- To create a custom role:
- Click Add Role.
- Enter a role name and description.
- Toggle permissions for each platform area (view, create, edit, delete).
- Click Save Role.
- Assign the new role to team members from the Team Members page.
| Permission Area | Available Actions |
|---|---|
| Products | View, Create, Edit, Delete |
| Orders | View, Edit, Cancel |
| Invoices | View, Create, Send, Void, Refund |
| Support | View, Respond, Assign, Close |
| Customers | View, Edit |
| Settings | View, Edit |
| Monitoring | View, Restart Services |
| Audit Log | View |
| Reports | View, Export |
Danger Zone
Critical, irreversible actions are isolated in the Danger Zone at the bottom of the Settings page.
Delete Workspace
Permanently deletes the entire workspace and all associated data.
- Scroll to the bottom of Settings.
- Click Delete Workspace in the Danger Zone section.
- Type the workspace name to confirm.
- Enter your password.
- Click Permanently Delete.
Warning: This action is irreversible. All data -- customers, orders, invoices, products, tickets, and configurations -- will be permanently deleted. Ensure you have exported all necessary data before proceeding. This action requires Admin role.
Related Guides
- Getting Started -- Theme and language preferences
- User Management -- Team members, roles, API keys, and security
- Billing & Invoices -- Currency settings and invoice configuration
- Reporting & Dashboard -- Notification preferences for alerts