Skip to content

General Settings

The General Settings page in the Admin Panel lets you configure your SetGet instance's identity, branding, and global preferences. These settings affect every user and workspace on the platform.

Navigate to Admin Panel > General Settings or go directly to /backoffice/settings/general.

Instance identity

Instance name

The instance name is displayed in browser tabs, email subject lines, and the login page header. Choose a name that identifies your organization or deployment.

PropertyDetails
FieldInstance Name
DefaultSetGet
Max length100 characters
Where it appearsBrowser tab title, email headers, login page, sidebar

Instance URL

The canonical URL of your SetGet deployment. This value is used to generate links in emails, API responses, and OAuth callback URLs.

PropertyDetails
FieldInstance URL
FormatFull URL with protocol (e.g., https://setget.example.com)
ImportantMust match the actual URL users access. Mismatched URLs break email links and OAuth flows.

WARNING

Changing the instance URL after deployment affects all existing email links and OAuth provider configurations. Update OAuth callback URLs at each provider when changing this value.

Instance description

A short description of your instance, shown on the login page below the instance name. Use it to communicate the purpose of the deployment or your organization's tagline.

PropertyDetails
FieldInstance Description
DefaultEmpty
Max length300 characters

Branding

Upload a custom logo that replaces the default SetGet logo throughout the application.

PropertyDetails
Recommended size200 x 40 px (landscape orientation)
Supported formatsPNG, SVG, JPEG
Max file size2 MB
Where it appearsLogin page, sidebar header, email headers

To upload a logo:

  1. Click Upload Logo on the General Settings page.
  2. Select your image file.
  3. Preview the logo in the sidebar and login page mockups.
  4. Click Save to apply.

To remove a custom logo and revert to the default, click Reset to Default.

Favicon

Upload a custom favicon for browser tabs and bookmarks.

PropertyDetails
Recommended size32 x 32 px or 64 x 64 px
Supported formatsPNG, ICO, SVG
Max file size512 KB

Brand colors

Customize the primary accent color used across the interface. This affects buttons, links, active states, and other UI elements.

SettingDescriptionDefault
Primary colorMain accent color (hex code)#3F76FF
Light variantAutomatically derived from primaryAuto
Dark variantAutomatically derived from primaryAuto

TIP

Choose a color with sufficient contrast against white backgrounds to maintain accessibility. Tools like the WebAIM Contrast Checker can help verify WCAG compliance.

Default timezone

Set the default timezone for the instance. This timezone is used for:

  • Displaying timestamps when a user has not set a personal timezone.
  • Scheduling system tasks (notification digests, report generation).
  • Audit log timestamps in the Admin Panel.
PropertyDetails
FieldDefault Timezone
FormatIANA timezone identifier (e.g., Europe/Istanbul, America/New_York)
DefaultUTC

TIP

Individual users can override the instance timezone in their personal profile settings. The instance timezone serves as the fallback.

Saving changes

After modifying any settings on this page:

  1. Review your changes in the live preview (where available).
  2. Click the Save Changes button at the bottom of the page.
  3. A confirmation toast will appear if the save was successful.

Changes to the instance name and branding take effect immediately for all users. Users may need to refresh their browser to see updated logos and favicons.

Settings reference

SettingLocationDefaultEnv Override
Instance NameGeneral SettingsSetGetSETGET_INSTANCE_NAME
Instance URLGeneral SettingsSETGET_INSTANCE_URL
Instance DescriptionGeneral SettingsEmpty
LogoGeneral SettingsSetGet logo
FaviconGeneral SettingsSetGet favicon
Primary ColorGeneral Settings#3F76FF
Default TimezoneGeneral SettingsUTCSETGET_DEFAULT_TIMEZONE

WARNING

Environment variable overrides take precedence over Admin Panel values. If an environment variable is set, the corresponding Admin Panel field will show the value but may be read-only.

Troubleshooting

ProblemCauseSolution
Logo not appearingFile too large or wrong formatUse PNG or SVG under 2 MB
Favicon not updatingBrowser cacheHard-refresh (Ctrl+Shift+R) or clear cache
Email links point to wrong URLInstance URL mismatchUpdate Instance URL to match the actual deployment URL
Timezone wrong on admin pagesDefault timezone not setSelect the correct IANA timezone and save