Settings list deprecated

Introduction

This page shows a list of useful config option to customize App Suite UI. We recommend to read the main article on how to configure App Suite UI first.

Namespaces

Settings are logically divided via namespaces for each module. The namespace itself is divided by a doube slash // from the setting's name when written down to a config file. Ensure to always use the double slash in your settings string, otherwise this will lead to errors and your setting will not work.

For example io.ox/core//someSetting or io.ox/mail//anotherMailSetting.

In this case we have two different namespaces, io.ox/core and io.ox/mail. The setting someSetting only exists in the core namespace, anotherMailSetting only in mail accordingly.

Data types

Ensure to always use the expected data type for a setting. This table lists some examples when they are set in a 'settings property file' (sometimes referenced as 'ui property file').

Data type Example
<bool> io.ox/core//features/dedicatedLogoutButton=true
<string> io.ox/core//features/windowHeaderPosition="top"
<number> io.ox/core//apps/quickLaunchCount=5
<array> io.ox/tasks//currencies=["CAD","CHF","EUR"]

Feature toggles

App Suite UI offers different feature toggles. These toggles control the appearance (or flavor) of different features in the UI.

io.ox/core//features/dedicatedLogoutButton=<bool> Show a logout button at the topbar.

io.ox/core//features/folderIcons=<bool> Show icons in the folder tree next to folder labels.

io.ox/core//features/logoutButtonHint=<bool> Shows a reminder tooltip if the user has not logged during the last page visit.

io.ox/core//features/reloginPopup=<bool> Show a modal dialog to enable an inline relogin without showing the login page.

io.ox/core//features/storeSavePoints=<bool> Enable/disable restorepoints for edit dialogs.

io.ox/core//features/validateMailAddresses=<bool> Enable validiation for email addresses in mail compose dialog.

io.ox/core//features/validatePhoneNumbers=<bool> Enable validiation for phone numbers.

io.ox/core//features/windowHeaderPosition=<string> Placement of buttons in new/edit dialogs. Default is 'bottom' ('top', 'bottom')

io.ox/core//disabledSettingsPanes=<string> Disable one or more settings panes via extension point ids of io.ox/settings/pane and it's subgroup extension points (easily identifiable as "&folder=virtual/settings/" in adress bar)

io.ox/core//pdf/enablePreconversionOnUpload=<bool> Enable/disable PDF preconversion of office documents on file upload and when a new file version is added. Default is true.

io.ox/core//pdf/enablePreconversionOnMailFetch=<bool> Enable/disable PDF preconversion of office documents for mail attachments. Default is true.

io.ox/core//pdf/enableRangeRequests=<bool> Enable/disable range requests support to fetch PDF rendering data in chunks. Default is 'true'.

Topbar / Apps

io.ox/core//apps/quickLaunchCount=<number> How many quick launch icons should appear in the Topbar by default (default: 3)

io.ox/core//apps/quickLaunch=<string> Default Apps for quick launcher. Comma-separated string of App IDs Default: 'io.ox/mail/main,io.ox/calendar/main,io.ox/files/main'

io.ox/core//logoFileName=<string> Change the default file name for the logo in the topbar. Default (logo.png)

io.ox/core//logoAction=<string> Change the action when clicking on the topbar logo. Either a URI to open in a new tab or an App ID. I.e. https://sample.com or io.ox/mail/main. Default is unset.

Notifications

io.ox/core//autoOpenNotificationarea=<bool> Open notification area automatically on new notification.

io.ox/core//notificationsHidingTimer=<number> Hide notifications for n milliseconds after the user clicks on 'Notify me again later' (default is 1800000 (30 minutes)).

io.ox/core//showDesktopNotifications=<bool> Show native desktop notifications. Default true. Important: Depends also on browser settings.

io.ox/core//properties/contactImageMaxWidth=<number> Maximum target image width when croping contact/user images in pixels (default: 500).

Feedback dialog

io.ox/core//feedback/show=<bool> Show one or more feedback buttons. Default value is 'both' which shows a dropdown entry in the settings menu and a button in the main content window. (topbar/side/both).

io.ox/core//feedback/supportlink<string> Hyperlink to a support site referenced in the feedback dialog.

io.ox/core//feedback/position<string> Set position of the feedback button. Default value is right. (left|right).

io.ox/core//feedback/showHover=<bool> Show rating string on mouse hover in feedback dialog.

io.ox/core//feedback/showModuleSelect=<bool> Defines if the feedback dialog is aware of it's current App and the rating is based on this. If set to "true" every App can be rated regardless which App is currently running.

Misc

io.ox/core//groups/limit=<number> Fetch limit for groups plugin when requesting details of members. Default 1000

io.ox/core//refreshInterval=<number> Automatic UI refresh interval in milliseconds (default 300000 (5 minutes)).

io.ox/core//settings/downloadsDisabled=<bool> Enables/disables download pane for additional software components in settings.

io.ox/core//theme=<string> Current user theme. Default default

io.ox/core//feedback/maxFeedbacks=<number> maximum number of feedbacks that are allowed in one timeframe (works with relative and absolute dates)

Default: 1 if io.ox/core//feedback/timeLimit is set else undefined (i.e. unlimited)

io.ox/core//feedback/timeLimit=<string> Can be relative or absolute ISO strings to define a time, e.g. “2020-01-21” or “3M” (meaning within 3 months). See momentjs parsing documentation for details.

Default: false

Mail compose: tinyMCE text editor

io.ox/core//maxUploadIdleTimeout Timeout for contenteditable-editor in milliseconds when adding inline images

io.ox/core//tinyMCE/theme_advanced_buttons1=<string> List of tinyMCE toolbar actions separated by space - targets toolbar1
Default: '*undo *redo | bold italic underline | bullist numlist outdent indent'

io.ox/core//tinyMCE/theme_advanced_buttons2=<string> List of tinyMCE toolbar actions separated by space - targets toolbar2) Default: empty

io.ox/core//tinyMCE/theme_advanced_buttons3=<string> List of tinyMCE toolbar actions separated by space - targets toolbar3 Default: empty

io.ox/core//tinyMCE/font_format=<string> List of availabe fonts (also used for settings pane). Default:

"System=-apple-system,BlinkMacSystemFont,helvetica,sans-serif;Andale Mono=andale mono,times;Arial=arial,helvetica,sans-serif;Arial Black=arial black,avant garde;Book Antiqua=book antiqua,palatino;Comic Sans MS=comic sans ms,sans-serif;Courier New=courier new,courier;Georgia=georgia,palatino;Helvetica=helvetica;Impact=impact,chicago;Symbol=symbol;Tahoma=tahoma,arial,helvetica,sans-serif;Terminal=terminal,monaco;Times New Roman=times new roman,times;Trebuchet MS=trebuchet ms,geneva;Verdana=verdana,geneva;Webdings=webdings;Wingdings=wingdings,zapf dingbats"

Metrics

io.ox/core//tracking/enabled=<bool> Enable tracking in App Suite UI

io.ox/core//tracking/donottrack=<bool> Respect "do not track" browser setting

Matomo, formerly known as Piwik

io.ox/core//tracking/piwik/enabled=<bool> Enable Matomo adapter for tracking

io.ox/core//tracking/piwik/lib=<string> Matomo js library url

io.ox/core//tracking/piwik/api=<string> Matomo url of server endpoint

io.ox/core//tracking/piwik/id=<string> Matomo id

Piwik Pro

io.ox/core//tracking/piwikpro/enabled=<bool> Enable Piwik Pro adapter for tracking

io.ox/core//tracking/piwikpro/lib=<string> Piwik Pro js library url

Google Analytics

io.ox/core//tracking/analytics/enabled=<bool> Enable Google Analytics adapter

io.ox/core//tracking/analytics/id=<string> Google analytics id

io.ox/core//tracking/analytics/url=<string> Analytics URL, usually https://www.google-analytics.com/analytics.js

io.ox/core//tracking/analytics/mapping=<string> Optional mappings for custom dimensions

Misc

io.ox/core//tracking/console/enabled=<bool> Enables debugging console adapter that logs events to browser console.

io.ox/core//tracking/context/enabled=<bool> Enabled context tracker that provides last 10 tracked events via window.ox.metrics

Upsell

io.ox/core//upsell/enabled=<bool> List of capabilities that are available for upsell.

io.ox/core//upsell/defaultIcon=<string> Default icon used for upsell 'decoration'.

io.ox/core//upsell/premium/folderView/visible=<bool> Show premium link in folder tree.

io.ox/core//upsell/premium/folderView/closedByUser=<bool> Is the user allowed to hide the premium link permanently.

io.ox/core//features/upsell/[feature-id]/enabled=<bool> Upsell enabled for feature.

io.ox/core//features/upsell/[feature-id]/color=<string> Customize upsell 'decoration' appearance.

io.ox/core//features/upsell/[custom-id]/icon=<string> Customize upsell 'decoration' appearance.

Password

If the capability 'edit_password' is set, a user can change his own password in App Suite UI.

io.ox/core//password/showStrength=<bool> Show password strength

io.ox/core//password/minLength=<number> Passwort minimum length

io.ox/core//password/maxLength=<number> Password max length

io.ox/core//password/regexp=<string> Check new password against a regular expression (i.e. "is there at least one upper case letter")

io.ox/core//password/special=<string> Required special characters for new passwords

Client Onboarding

io.ox/core//features/clientOnboardingHint/enabled=<bool> Enables a hint on mobiles to inform about the onboarding Wizard (true/false)

io.ox/core//features/clientOnboardingHint/remaining=<number> Number of times hint is beeing shown. The protection of this setting needs to be disabled in any case.

Misc

io.ox/core//autoLogout=<bool> Timeout until a user is logged out automatically if inactive

io.ox/core//autoStart=<string> First App to start after login, Default: io.ox/mail/main

io.ox/core//autoStartMobile=<string> First App to start after login on mobile devices. Default: io.ox/mail/main

io.ox/core//selectionMode=<string> Specifies behavior when selecting items in mail listview. Default: normal ('normal'|'alternative'|'simple')

Portal

Please read http://oxpedia.org/wiki/index.php?title=AppSuite:Configuring_portal_plugins for detailed information and expamples how to customize the App Suite UI Portal and pre configure widgets for users.

First Start Widget

io.ox/portal//settings/getStartedLink=<string> Target of 'get started' labled link in 'getting started' widget

Widget properties

io.ox/portal//widgets/user/[widgetid]/color=<string> Color of title and highligting within widget preview/content

io.ox/portal//widgets/user/[widgetid]/enabled=<bool> Enabled state

io.ox/portal//widgets/user/[widgetid]/index=<string> Specifies order of widgets. I.e. first or numeric value

io.ox/portal//widgets/user/[widgetid]/inverse=<bool> Use color for background instead of title

io.ox/portal//widgets/user/[widgetid]/plugin=<string> Reference to tht plugin id/path. I.e "plugins/portal/birthdays/register"

io.ox/portal//widgets/user/[widgetid]/props=<string> Additional data like custom description or related configuration

io.ox/portal//widgets/user/[widgetid]/type=<string> Widget type like rss or stickyfile

Misc

io.ox/portal//mobile/summaryView=<bool> User setting, show only a small summary view of each widget on smartphones

Mail

io.ox/mail//allowHtmlImages=<bool> Allow pre-loading of externally linked images.

io.ox/mail//allowHtmlMessages=<bool> Allow HTML formatted emails.

io.ox/mail//displayEmoticons=<bool> Display emoticons as graphics in text emails.

io.ox/mail//isColorQuoted=<bool> Colored quotes in emails.

io.ox/mail//useFixedWidthFont=<bool> Use fixed-width font for text emails.

io.ox/mail//beautifyPlainText=<bool> Prettify plain text emails.

io.ox/mail//sendDispositionNotification=<bool> Show requests for read receipts.

io.ox/mail//autoselectMailOnStart=<bool> Automatically select first read mail on mail app start. (Default true)

io.ox/mail//features/textPreview=<bool> Fetch mail teaser texts if available, only supported by Dovecot for primary accounts. Also needs MW config. (Default true)

User Preferences:

io.ox/mail//removeDeletedPermanently=<bool> Permanently remove deleted emails instead of moving them to the trash folder first (true|false)

io.ox/mail//contactCollectOnMailTransport=<bool> Automatically collect contacts in the folder "Collected addresses" while sending - depends on capability 'collect_email_addresses' (true|false)

io.ox/mail//contactCollectOnMailAccess=<bool> Automatically collect contacts in the folder "Collected addresses" while reading - depends on capability 'collect_email_addresses' (true|false)

io.ox/mail//features/registerProtocolHandler=<bool> Ask for mailto link registration (true|false)

io.ox/mail//features/trusted/user=<string> User-defined, comma-separated list of mail adresses or specific domains which will be whitlisted for loading external images in HTML mails.

io.ox/mail//features/trusted/admin=<string> Admin-defined, comma-separated list of mail adresses or specific domains which will be whitlisted for loading external images in HTML mails. I.e. useful for customer care email addresses or domains.

io.ox/mail//unseenMessagesFolder=<bool> Show folder with all unseen messages (true|false)

io.ox/mail//playSound=<bool> Play sound on incoming push email - depends on capability 'websocket' otherwise the option will not be shown.

io.ox/mail//notificationSoundName=<string> Default sound to play on incoming push mail. Default bell, can be one of bell, marimba, wood, chimes

Compose

io.ox/mail//appendVcard=<bool> Append vCard to email.

io.ox/mail//appendMailTextOnReply=<bool> Insert the original email text to a reply.

io.ox/mail//confirmReplyToMailingLists=<bool> Confirm recipients when replying to a mailing list. Useful to avoid flooding mailing lists with unwanted replies to the list.

io.ox/mail//forwardMessageAs=<string> Value Inline (default) or Attachment.

io.ox/mail//messageFormat=<string> Value html (default), text or alternative.

io.ox/mail//defaultSendAddress=<string> Default sender address from available accounts. Default not set.

io.ox/mail//autoSaveAfter=<number> Interval to update composition space during compose in milliseconds. Default: 15000 (15 seconds)

io.ox/mail//autobcc=<bool> Always add the following recipient to BCC.

io.ox/mail//defaultFontStyle/family=<string> Value browser-default, Andale Mono or one of io.ox/core//tinyMCE/font_format. Desktop only.

io.ox/mail//defaultFontStyle/size=<string> Value browser-default or i.e. 8pt. Desktop only.

io.ox/mail//defaultFontStyle/color=<string> Default font color as CSS color string. I.e. #334455

io.ox/mail//showReplyTo/configurable=<bool> Show 'reply to' field

io.ox/mail//maxSize/compose=<number> Max size of returned characters for mail reply/forward in bytes (API parameter) Default: 524288 (512 kB)

io.ox/mail//maxSize/view=<number> Max size of returned characters for mail viewing in bytes. Default: 102400 (100 kB)

io.ox/mail//features/instantAttachmentUpload=<bool> Feature toggle to enable/disable instant attachment upload. Default is 'true'

Mail compose: Image resize

io.ox/mail//features/imageResize/enabled=<bool> Feature toggle to enable resizing of images

io.ox/mail//features/imageResize/default=<string> Feature toggle to enable resizing of images (default 320)

io.ox/mail//features/imageResize/small=<number> Size of the target image (longest edge) for a small image as integer (default 320)

io.ox/mail//features/imageResize/medium=<number> Size of the target image (longest edge) for a medium image as integer (default 640)

io.ox/mail//features/imageResize/large=<number> Size of the target image (longest edge) for a large image as integer (default 1280)

io.ox/mail//features/imageResize/quality=<number> Quality for the compression while resizing as float (default 0.75)

io.ox/mail//features/imageResize/imageSizeThreshold=<number> Threshold for the size in pixel of the longest edge after which a resize is recommended as integer (default 1024)

io.ox/mail//features/imageResize/fileSizeMax=<number> Maximum size in bytes that will be resized as integer, if one image exceeds this threshold the resize dropdown will not be displayed (default 10485760)

Signatures

io.ox/mail//defaultSignature=<number> ID of default signature. Signatures are stored as Snippets on MW (DB)

io.ox/mail//defaultReplyForwardSignature=<number> ID of default forward and reply signature. Fallback is value of 'defaultSignature'

io.ox/mail//defaultSignaturePosition=<string> value is above or below (default below)

io.ox/mail//mobileSignatureType=<string> Value is custom or none. If custom is set, signature from io.ox/mail//mobileSignatureis taken.

io.ox/mail//mobileSignature=<string> Mobile signature as plain text string.

io.ox/mail//compose/signatureLimit=<number> Number of signatures listed in options dropdown of mail compose (default 2).

Misc

io.ox/mail//attachOriginalMessage=<bool> Attach original message on touch devices

io.ox/mail//features/accounts/configureUnifiedInboxOnCreate=<bool> Allow enabling unified inbox for an account at the "Add Mail account" dialog

io.ox/mail//features/authenticity=<bool> Enables the authenticity feature. Please note that com.openexchange.mail.authenticity.enabled on MW has to be turned on as well. (default: false)

<-- currently hardcoded as 'fail_neutral_trusted' and 'protected' by MW and not adjustable by any property file change or user interaction. io.ox/mail//authenticity/level=<string> If authenticity is enabled on MW and UI (see features/authenticity) and this value is not marked as proteced, the user can select a level which controls how strict the authenticty results are shown at UI side. (default: none, values: none, fail_neutral_trusted and all) -->

io.ox/mail//features/autoCollapseBlockquotes=<bool> If enabled, blockquotes larger than 300 chars will be collapsed.

io.ox/mail//features/cleanSubjects=<bool> Remove clutter from subjects like AW: or RE:

io.ox/mail//features/notifyOnSent=<bool> Show an infopopup after mail was send successfully. Default false

io.ox/mail//listview/primaryPageSize=<number> Initial size of mail list until pagination will start. Default 50

io.ox/mail//listview/secondaryPageSize=<bool> Sets how many mails will loaded on each paginate call. Default 200

io.ox/mail//prefetch/count=<bool> Prefetch N mails on Mail App startup. Default 5

io.ox/mail//features/prefetchOnBoot='' Prefetch the first chunk of mail data (action=all) already on App Suite boot. Only disable this if you want to customize mail columns later on. Default true

io.ox/mail//prefetch/next=<bool> Prefetch next mail in line during list traversing via cursor or selection. Default true

io.ox/mail//transform/multipleEmptyLines=<bool> reduce multiple empty lines in plain text mails to a maximum of 2 (detail view, compose: html-to-text). Default true

io.ox/mail//features/usePrimaryAccountNameInTree=<bool> Use the primary account name as label for the folder tree root node of non standard folders. If set to false the the String 'My Folders' will be used. Default true

Contacts

General

io.ox/contacts//showAdmin=<bool> Show context admin in addressbook. Default false

io.ox/contacts//showDepartment=<bool> Whenever a contact from the global addressbook is rendered, additionally show the department (field) next to the name. Default false

io.ox/contacts//startInGlobalAddressbook=<bool> Start in global addressbook when Contacts App is launched. Default true

io.ox/contacts//mapService=<string> External map service to locate addresses. One of google (Google Maps, default), osm (Open Street Map) or apple (Apple Maps, only works on iOS and MacOS)

io.ox/contacts//toolbar/limits/fetch=<number> Fetch limit when selecting multiple contacts. A number of selected contacts beyond this limit might led to unavailable toolbar actions. Default 100

Addressbook picker

io.ox/contacts//picker/limits/departments=<number> Maxium departments to show. Default 100

io.ox/contacts//picker/limits/fetch=<number> Maximum number of contacts to fetch. Default 10000

io.ox/contacts//picker/limits/list=<number> Max elements shown in the list before first paginate. Default 100

io.ox/contacts//picker/limits/more=<number> Elements for addition loading on each subsequent paginate call. Default 100

io.ox/contacts//picker/limits/search=<number> Maximum search results. Default 50

Calendar

User settings

io.ox/calendar//startTime=<number> Start of working time as hour of the day in current timezone. Default 8

io.ox/calendar//endTime=<number> End of working time as hour of the day in current timezone. Default 18

io.ox/calendar//interval=<number> Selected calendar grid scale interval in minutes. One of 5, 10, 15, 20, 30, 60. Default 30.

io.ox/calendar//showDeclinedAppointments=<bool> Should declined appointments be displayed in the user calendar. Default true

io.ox/calendar//deleteInvitationMailAfterAction=<bool> Automatically delete appointment invitation emails after the appointment has been accepted or declined.

io.ox/calendar//markFulltimeAppointmentsAsFree=<bool> Mark all day appointments as 'free' for free/busy views. Default false

io.ox/calendar//notifyNewModifiedDeleted=<bool> Receive notification emails for appointment changes where the user is participants. Default true

io.ox/calendar//notifyAcceptedDeclinedAsCreator=<bool> Receive notification emails as appointment organizer when participants accept or decline. Default false

io.ox/calendar//notifyAcceptedDeclinedAsParticipant=<bool> Receive notification emails as appointment participants when other participants accept or decline. Default false

io.ox/calendar//deleteInvitationMailAfterAction=<bool> Automatically delete invitation emails after the appointment has been accepted or declined. Default true

io.ox/calendar//numDaysWorkweek=<number> Number of days in a work week. Default 5

io.ox/calendar//workweekStart=<number> Day to start the workweek. Numeric where Sunday is 0. Default 1 (Monday)

io.ox/calendar//favoriteTimezones=<string> Array of timezones like ['Europe/Berlin']

io.ox/calendar//renderTimezones=<bool> Array of timzones that specifies that timezones out of the favoriteTimeszones that should be displayed

io.ox/calendar//showPastReminders=<bool> Determines if reminders should be shown for appointments in the past. This does not affect reminders that are set to trigger after an appointment ends. Default is true.

Scheduling view

io.ox/calendar//scheduling/zoom=<number> Zoom level in percent. One of 10, 25, 50, 100, 200, 400 or 1000. Default 100

io.ox/calendar//scheduling/compact=<bool> Use compact mode for scheduling view, rows take less vertical space. Default false

io.ox/calendar//scheduling/showFree=<bool> Show/hide appointments that are marked as free. Default false

io.ox/calendar//scheduling/showReserved=<bool> Show/hide appointments that are marked as reserved. Default false

io.ox/calendar//scheduling/onlyWorkingHours=<bool> Show only working hours in scheduling view. Default true

io.ox/calendar//scheduling/dateRange=<string> Show either one week or the complete month in the view (week or month). Default week

Misc

io.ox/calendar//defaultFolderColor=<string> Calendar folder color as CSS HEX string, defaults to #CFE6FF

io.ox/calendar//freeBusyStrict=<bool> Hide appointment data in planning view for all appointment where the user is not an participants. Default true

io.ox/calendar//participantBlacklist=<string> List of blacklisted participants which can not be added to appointments. Useful for mailing lists.

io.ox/calendar//viewView=<string> value is 'week:day', 'week:workweek', 'week:week', 'month' or 'list'

Files

io.ox/files//showHidden=<bool> Show hidden files and folders. Default false

io.ox/files//uploadHandling=<string> Strategy how to handle files with identical names. One of newVersion, announceNewVersion or newFile. Default announceNewVersion.

io.ox/files//autoplayPause=<number> Slideshow / Autoplay mode pause in seconds. Default 5

io.ox/files//audioEnabled=<bool> Play audio files in viewer. Default true

io.ox/files//videoEnabled=<bool> Play video files in viewer. Default true.

io.ox/files//autoplayLoopMode=<string> Autoplaymode of the viewer. loopEndlessly or loopOnlyOnce. Default loopEndlessly

io.ox/files//features/comments=<bool> Allow comments when uploaded a new version of a file. Default true

Tasks

io.ox/tasks//notifyAcceptedDeclinedAsCreator=<bool> Receive notifications when a participant accepted or declined a task created by you. Default false

io.ox/tasks//notifyAcceptedDeclinedAsParticipant=<bool> Receive notifications when a participant accepted or declined a task in which you participate. Default false

io.ox/tasks//notifyNewModifiedDeleted=<bool> Receive notifications when a task in which you participate is created, modified or deleted. Default false

Portal: OX Drive Clients Widget

plugins/portal//oxdriveclients/appIconAsBase64=<string> App icon encoded as base64 string.

plugins/portal//oxdriveclients/l10nImages=<string> Array of language strings like 'en,de,es'. This will indicate which localized app store images are present. Default ['de', 'en', 'es', 'fr', 'it', 'nl']

plugins/portal//oxdriveclients/linkTo/[windows|android|ios|macos]=<string> Link to Appstore or download location

plugins/portal//oxdriveclients/productName=<string> Customized product name for OX Drive. Default OX Drive