User Settings provide options for configuring Portal applications:

Admin settings

User needs to have role AXONIVY_PORTAL_ADMIN to see this menu item, it is used to configure Portal configuration, see different Portal configurations in General concept

Global settings

Global settings for Portal can be set in Settings tab. All available settings with their default value and description are listed in this place.

You can edit value for a specific setting

You can also get back the default value for each setting by clicking reset button on each row, or reset all values of all settings by clicking Restore All To Defaults button

Setup multi portals


Multi applications on multi engines is not officially supported, only an experimental mode is available.


There is 2 ways to configure portals: two levels and single level

  • Two levels portal

    • Used for related applications where we need an overview of all tasks and cases.

    • There is default application Portal.

    • Create new applications: App1, App2, App3... Deploy portal (kit, template ..) to new applications.

    • Configure multi-apps Portal on single server: login by Portal Admin. Configure 1 server then configure applications: App1, App2, App3...

    • Note that, do not add default Portal application, the default application (Dashboard) is reserved for displaying all tasks/cases... from all configured applications.

    • Dashboard menu only visible when login user exists in Portal application.

  • Single level portal

    • Used for independent applications.

    • Disable the default application Portal.

    • Create new applications: App1, App2, App3... Deploy portal(kit, template ..) to new applications.

    • Configure multi-apps Portal on single server: login by Portal Admin. Configure 1 server then configure applications: App1, App2, App3...

  1. Add a new server

    1. Open Admin Settings by selecting the item in UserMenu on the topbar, if your page using layout of PortalTemplate .


      If your application does not use templates of PortalTemplate project, you have to create a page and use AdminSettings component inside.


      To be able to open Admin Settings dialog, user needs to have role AXONIVY_PORTAL_ADMIN .
    2. Click on New button to add new server.


      • Server path must be the link of the PortalConnector application (e.g. http://localhost:8080/ivy/ws/System/PortalConnector ). Note that the port in the link is the web server port

      • Web services authentication of the built-in PortalConnector of the Axon.ivy engine are configured as HTTP Basic . Therefore, when adding a new server using the built-in PortalConnector, use authentication type HTTP Basic .

      • The username, password are used by PortalKit to invoke the web services of PortalConnector.

        These are accounts of the application that deploys PortalConnector.

        The built-in PortalConnector are deployed to application System therefore use the username/password of system administrators (account to login to administration tool) when connecting to built-in PortalConnector.

        To create system administrators, refer to the document EngineGuide > chapter Configuration > Engine Configuration > System Administrators . E.g. in the latest EngineGuide, refer to this guideline .


      • In multi-Portal mode, Portal uses the External Host value as host value for task or process starts URLs. If this value is empty, Portal will use the host value as configured in the server path field. For other mode, Portal will use the host value of the web address of the engine for the URLs.

      • External Host value is returned from configured server's system property WebServer.ExternalHostName (you might want to change it via Engine's AdminUI ).

        You can sync this value by clicking Test Connection button, if WebServer.ExternalHostName is set the value would be updated, otherwise displays AUTO_DETECT .

        Configured server information is needed for calling service to get this value.

  2. Add a new application

    Choose Application tab on Admin Settings dialog and click on New button to add new application. Here you can choose application type either as Ivy application or Third Party application.


    • Application name is the name of the application when you create it. Display name is the name of the application to be shown on Portal UI.

    • If Active is not checked, the application will be disabled on the application menu. To prevent its tasks, cases and processes to be shown, you must leave the Visible box unchecked.

    • Portal link specifies the link you will be redirect to when selecting the application on the application menu. It could be an absolute link (e.g. or relative link (e.g. /ivy/pro/.../PortalStart.ivp). If your application could be accessed from multiple domains, use relative link so that you can access the link from different domains.

    • Absence planning if checked will enable absence feature for the application.

    • Mail notification If checked will enable email setting feature for the application.

    • For multiple languages of application display name, you need to create the "AppInfo/SupportedLanguages" CMS which defines how many languages your application supports. See the below "Language settings" for more details.

  3. Synchronize data

    After adding new settings (server, application), click on Synchronize Settings to synch new settings and information about users to registered servers. Close dialog (logging out may be required) and check if newly created application is available on left menu.


    In single mode, Portal detects the applications that have the login user in the current engine. Based on that, Portal will collect tasks, cases of those applications. In multi-portal mode, Portal will only collect on registered applications.

    By default, Portal will automatically synchronize user settings to registered servers at 5AM everyday. This synchronization process is needed to run at only one application for each server. If there are multiple applications registered for one server, the first application in alphabetical order will run the synchronization process. You can change the time when the synchronization start by going to AdminUI and change the value of the global variable PortalStartTimeSynchUserExpression of the application that will run the synchronization process.

Absence and substitute settings

  • Choose Absences from User Settings options.

  • To create new Absence, click New Absence to open the dialog as below:

    • till/from date must not be empty.

    • till date must be greater than or equal from .

    • till date must not be in the past (greater than or equal today).

  • User can edit or delete Absences by click edit/delete on the Absences list.

  • Deputies area will display all the information of deputy on each application.

  • User cannot set deputies for hidden roles.

  • All the items will be saved after click Save button.

Email settings

  • To configure mails of Portal applications, select Email Settings in User Settings .

  • You can configure one email setting for all applications or each application separately.

  • There are 2 types of emails notification: Ivy email notification sent when task is assigned (More information about the email notification can be found here) and other emails sent from processes of customer project.

  • All the items will be saved when click save button.

Language settings

  • To configure languages of Portal applications, select Language Settings in User Settings .

  • UI reads current languages settings for all applications.

  • To change language for application, select one in the languages dropdown list of application. When the change is saved, the language will be set for application (Click on the application in header menu to reload application and see the change of language).

  • For multiple languages, the CMS key /AppInfo/SupportedLanguages must exist in your application. From Portal 7.1, this CMS entry is moved to Portal Style. It contains list of all languages supported by your application, separated by comma.

    • Must not contain spaces
    • Same as display name of Locale
    • Separated by comma
    • Process model version, which has this CMS, must active
  • To add new language to Portal, what you have to do is

    • Add new language locale to cms entry of Portal Style /AppInfo/SupportedLanguages
    • Export all CMS entries of Portal Style to excel file
    • Add translation of new language for all CMS entries
    • Import file excel back, then redeploy Portal Style
    • This is sample how to add new Spanish to portal