General Settings
Manage your profile information and display preferences in the General settings section.
Accessing General Settings
Navigate to Settings > General or go directly to /settings in your browser.
Profile Information
Your profile contains information about your account and how you appear in Orkestia.
Display Name
Your display name appears across the platform in comments, activity logs, and team member lists.
Editing Your Display Name
- Go to Settings > General
- Find the Display Name field
- Enter your new name (minimum 2 characters)
- Click Save changes
Validation Rules
| Rule | Value |
|---|---|
| Required | Yes |
| Minimum Length | 2 characters |
| Can be changed | Yes, anytime |
| Format | Any text (letters, numbers, spaces, special characters) |
Expected Behavior
- Immediate Update: Display name changes take effect immediately across the platform
- Success Message: You'll see a success toast notification after saving
- Error Handling: If save fails, an error message is shown and changes are not applied
Email Address
Your email address is used for login and notifications.
| Property | Value |
|---|---|
| Editable | No (read-only) |
| Managed by | AWS Cognito (your authentication provider) |
| Purpose | Used for login, notifications, and account recovery |
Username
Your username is your unique identifier on the platform.
| Property | Value |
|---|---|
| Editable | No (read-only, permanent) |
| Format | Unique identifier, may include provider prefix |
| Examples | user@example.com, google_123456789, github_username |
Account Information
View additional account details:
- Authentication Provider - How you signed up (Cognito, Google, GitHub, etc.)
- Member Since - When you joined your first organization
Preferences
Timezone Settings
Set your preferred timezone for displaying dates and times throughout the platform.
Timezone Options
Auto (Default)
- Uses your browser's detected timezone
- Automatically detects your location
- Updates if you change your device's timezone
Specific Timezone
- Choose from a list of timezones
- Searchable dropdown with all timezones
- Examples:
America/New_York,Europe/London,Asia/Tokyo
How to Change Timezone
- Open the Timezone dropdown
- Select Auto or choose a specific timezone
- Changes are saved automatically (no save button needed)
- You'll see a success toast notification
How Timezone Affects Display
When you set a timezone:
- Dates: Displayed in your selected timezone
- Times: All times shown in your timezone
- Activity Logs: Timestamps in your timezone
- Notifications: Notification times in your timezone
Saving Changes
Profile Changes
To save profile changes (Display Name):
- Edit the Display Name field
- Click Save changes button
- Wait for the save to complete
- You'll see a success or error message
Preference Changes
Timezone preferences save automatically:
- No save button required
- Changes apply immediately
- Success toast notification appears
Best Practices
Display Name
- Use Your Real Name: Makes it easier for team members to identify you
- Keep It Professional: Your name appears in activity logs and comments
- Update When Needed: Change your name if it changes (e.g., marriage, legal name change)
Timezone
- Use Auto: Recommended for most users (automatic detection)
- Set Manually: If auto-detection is incorrect or you travel frequently
- Check After Travel: Update timezone if you move to a different timezone
Common Questions
Can I change my email address?
Email addresses are managed by AWS Cognito. To change your email, use your authentication provider's settings or contact support.
Can I change my username?
No, usernames are permanent and cannot be changed. They're used as unique identifiers across the platform.
Why doesn't my timezone sync across devices?
Timezone preference is stored locally in your browser for performance and privacy. Set it on each device you use.
What happens if I clear my browser data?
If you clear localStorage, your timezone preference will reset to "Auto". Your display name and other server-stored settings are unaffected.