- Documentation
- Account
- Account settings fields
Account settings fields
Reference for account name, subdomain, contact and support email, default timezone and locale, and who can change each.
Your account settings hold the identity and defaults for your whole account: its name, its subdomain, the contact and support email addresses, and the timezone and locale used across schedules, reports, and automated email. This page lists every field you can edit, its rules, and the errors you can hit.
Settings live at /settings/general on your account subdomain (for example acme.taskjuice.ai/settings/general). The page is split into three cards: Identity, Defaults, and Danger zone.
Who can edit settings
Changing any field on this page requires an account Admin or Owner role. Account Members can view the account but cannot edit settings; the save and rename requests return 403 Tenant admin required for them. See Roles and permissions for the full capability matrix.
Identity fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| Account name | Text, 1 to 120 characters | Yes | None | Shown in the account header, client workspace invitations, and branded email footers. |
| Subdomain | Text, 2 to 50 characters, lowercase letters, numbers, and hyphens only | Yes | None | Your account URL, displayed as {subdomain}.taskjuice.ai. Changed through Rename, not the main save button. |
The account name saves with the rest of the General form. The subdomain is shown read-only next to a Rename button, because changing it moves your account to a new URL. See Rename the subdomain below.
Defaults fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| Account owner email | Yes | The signing-up user's email | Where billing receipts and security alerts are sent. This is a single account contact, not a per-user setting; any admin can change it. | |
| Client-facing support email | No | None | Shown to your clients in automated emails sent from your workspaces. Leave empty to omit it. | |
| Default timezone | Text, IANA timezone name | Yes | UTC | Timezone used for schedules, reports, and account-level defaults. Example: America/New_York. |
| Default locale | Text, BCP 47 locale tag | Yes | en-US | Locale for dates, numbers, and default email language. Example: en-US. |
The four Defaults fields plus the account name all save together through one request. A successful save shows a Defaults updated confirmation.
The default timezone must be a valid IANA zone name such as UTC, America/Los_Angeles, or Europe/London. The default locale must be a valid BCP 47 tag such as en-US, en-GB, or fr-FR. An invalid value is rejected before anything is saved.
Rename the subdomain
Your subdomain is part of every URL your team and clients use, so it changes through a dedicated flow rather than the main save button. When you rename it, TaskJuice keeps the old subdomain working as a redirect for 60 days, so existing links and bookmarks do not break immediately.
Open the rename dialog
On the Identity card, select Rename next to your current subdomain.
Enter the new subdomain
Type the new subdomain. It must be 2 to 50 characters and use only lowercase letters, numbers, and hyphens.
Acknowledge the 60-day alias
Confirm that the old subdomain stays live as a redirect for 60 days. The rename will not proceed until you acknowledge this.
Confirm
Submit the rename. On success, your browser is redirected to the same settings page on the new URL:
https://{newSubdomain}.taskjuice.ai/settings/general.
After a rename, the previous subdomain redirects to the new one for 60 days. Update saved links and integrations before that window ends, because the old subdomain stops resolving once it expires.
Delete the account
The Danger zone card holds the Delete agency action. Selecting it schedules the account for deletion rather than removing it immediately. Final removal happens 7 days after you schedule it.
While an account is scheduled for deletion, every settings field is locked. A banner reads "This agency is scheduled for deletion. Settings cannot be edited until restored," and save and rename requests return 409 Tenant is scheduled for deletion until the account is restored.
The Owner cannot delete the account while another user still needs it; ownership rules are covered in Transfer ownership.
Errors
| HTTP status | Message | Cause |
|---|---|---|
| 400 | Invalid patch | A submitted field failed validation, such as a name over 120 characters or an invalid email. |
| 400 | Slug must be 2-50 lowercase letters, numbers, and hyphens | The requested subdomain breaks the length or character rules. |
| 403 | Tenant admin required | You hold the Member role; only Admin or Owner can edit settings or rename the subdomain. |
| 409 | Slug is reserved | The requested subdomain is on the reserved list and cannot be used. |
| 409 | New slug matches current slug | The requested subdomain is identical to the current one. |
| 409 | (slug collision) | The requested subdomain is already taken by another account. |
| 409 | Tenant is scheduled for deletion | The account is pending deletion, so all settings are locked until it is restored. |
| 429 | Too many requests | You changed settings or renamed too many times in a short window. Wait for the retryAfterSeconds value in the response, then try again. |
Limits
- Account name: 1 to 120 characters.
- Subdomain: 2 to 50 characters, lowercase letters, numbers, and hyphens only.
- Account owner email and support email: valid email addresses up to 254 characters.
- The default timezone must be a recognized IANA zone name; the default locale must be a valid BCP 47 tag.
- A renamed subdomain's old alias lasts exactly 60 days. There is no way to extend it.
- Security policy fields such as required MFA are not on this page. They live on the Security settings page; see Protect your account.
Related
- Roles and permissions: which roles can edit settings.
- Account overview: how accounts, workspaces, and roles fit together.
- Protect your account: MFA enrollment and account-wide MFA enforcement.