{"id":22500,"date":"2026-08-03T09:13:28","date_gmt":"2026-08-03T09:13:28","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=22500"},"modified":"2026-08-17T10:35:38","modified_gmt":"2026-08-17T10:35:38","slug":"how-to-configure-user-preference-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-user-preference-in-idempiere\/","title":{"rendered":"How to Configure User Preference in iDempiere"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">The User Preference window in iDempiere lets each user configure personal navigation, entry and display settings.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Introduction<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The User Preference window in iDempiere lets a logged-in user personalize how the application behaves for their own session, without affecting other users. It controls navigation, save, zoom and search behaviour at the individual user level.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">It is accessed from the Preference link available on every standard iDempiere screen, and applies across all windows the user opens during data entry, review and reporting.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Process Flow<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"272\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/UserPreference-1024x272.png\" alt=\"\" class=\"wp-image-22501\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/UserPreference-1024x272.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/UserPreference-300x80.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/UserPreference-768x204.png 768w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/UserPreference-1536x409.png 1536w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/UserPreference.png 1552w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Business Rules<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Preferences are stored per Tenant, Organization and User\/Contact combination.<\/li>\n\n\n\n<li>An Organization value of * applies the preference across all organisations for that user.<\/li>\n\n\n\n<li>Save on Navigate automatically saves an edited record when the user moves to another record.<\/li>\n\n\n\n<li>Toggle on Double Click lets a checkbox field be switched by double-clicking the row.<\/li>\n\n\n\n<li>Automatic Decimal Places For Amounts sets the default decimal precision shown on amount fields.<\/li>\n\n\n\n<li>Automatic New Record opens a blank new record automatically after a save completes.<\/li>\n\n\n\n<li>Detailed Zoom Across expands the list of related windows offered when zooming from a record.<\/li>\n\n\n\n<li>Use Similar To changes default text search to a similar-to (fuzzy) match instead of exact match.<\/li>\n\n\n\n<li>Read Only Session, when enabled, prevents the user from saving any changes during that session.<\/li>\n\n\n\n<li>View find result determines whether the Find window opens in Default or Grid layout by default.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Prerequisites<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>User must be logged in with a valid iDempiere User\/Contact account.<\/li>\n\n\n\n<li>User must have access to the Tenant and Organization the preference applies to.<\/li>\n\n\n\n<li>Role must permit access to the User Preference window if opened from the menu tree.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Configuration Steps<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 1: Open User Preference<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This step is required to reach the personal settings screen for the logged-in user. Click the Preference link at the top-right of any iDempiere window.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Description<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Tenant<\/td><td>POTS<\/td><td>Client organisation the preference belongs to.<\/td><\/tr><tr><td>Organization<\/td><td>*<\/td><td>Scope of the preference; * applies to all organisations.<\/td><\/tr><tr><td>User\/Contact<\/td><td>SuperUser<\/td><td>The user this preference record applies to.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">The window always opens scoped to the currently logged-in user and cannot be used to edit another user&#8217;s preferences.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 2: Set Navigation and Save Behaviour<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This step is required to control how the session responds while moving between records. Enable or disable the relevant checkboxes based on the user&#8217;s preferred data-entry style.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Description<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Save on Navigate<\/td><td>Checked<\/td><td>Automatically saves changes when leaving the current record.<\/td><\/tr><tr><td>Toggle on Double Click<\/td><td>Unchecked<\/td><td>Allows checkbox fields to be toggled with a double-click.<\/td><\/tr><tr><td>Automatic New Record<\/td><td>Checked<\/td><td>Opens a new blank record automatically after saving.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">These flags apply immediately to the user&#8217;s session once the record is saved.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 3: Set Display and Search Behaviour<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This step is required to define how amounts, zoom targets and searches appear for the user. Configure the decimal, zoom and search-related fields.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Description<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Automatic Decimal Places For Amounts<\/td><td>0<\/td><td>Default number of decimal places shown on amount fields.<\/td><\/tr><tr><td>Detailed Zoom Across<\/td><td>Unchecked<\/td><td>Shows an expanded list of related zoom target windows.<\/td><\/tr><tr><td>Use Similar To<\/td><td>Unchecked<\/td><td>Uses similar-to matching instead of exact match in searches.<\/td><\/tr><tr><td>View find result<\/td><td>Default<\/td><td>Default layout used when opening the Find window.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Changes to search and zoom behaviour take effect the next time the user opens Find or Zoom.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 4: Set Session and Help Options<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This step is required to control session write access and the level of help detail shown. Review the Read Only Session, Show Technical Information on Help and Active fields.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Description<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Read Only Session<\/td><td>Unchecked<\/td><td>When checked, prevents saving changes during the session.<\/td><\/tr><tr><td>Show Technical Information on Help<\/td><td>Unchecked<\/td><td>Displays technical field details in the Help popup.<\/td><\/tr><tr><td>Active<\/td><td>Checked<\/td><td>Indicates the preference record is active and in use.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">A user with Read Only Session enabled can navigate and view data but cannot save any record.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 5: Save the Preference Record<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This step is required to apply the selected personalization to the user&#8217;s future sessions. Save the record using the standard toolbar Save action.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"527\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/TenthPlanet-iDempiere-GeneralRules-UserPreference.png\" alt=\"TenthPlanet-iDempiere-GeneralRules-UserPreference\" class=\"wp-image-22502\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/TenthPlanet-iDempiere-GeneralRules-UserPreference.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/TenthPlanet-iDempiere-GeneralRules-UserPreference-300x154.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/TenthPlanet-iDempiere-GeneralRules-UserPreference-768x395.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">After completing the configuration, the window is ready for use in standard iDempiere transactions.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Issue<\/strong><\/td><td><strong>Cause<\/strong><\/td><td><strong>Resolution<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Preference changes not applied<\/td><td>Session was not restarted after saving<\/td><td>Log out and log back in, or reopen the window.<\/td><\/tr><tr><td>Cannot save any record<\/td><td>Read Only Session is enabled<\/td><td>Uncheck Read Only Session in User Preference.<\/td><\/tr><tr><td>Amount fields show wrong decimals<\/td><td>Automatic Decimal Places For Amounts set incorrectly<\/td><td>Update the field to the required decimal precision.<\/td><\/tr><tr><td>Unwanted auto-save on navigation<\/td><td>Save on Navigate is enabled<\/td><td>Disable Save on Navigate if manual save is preferred.<\/td><\/tr><tr><td>Too many zoom targets listed<\/td><td>Detailed Zoom Across is enabled<\/td><td>Disable Detailed Zoom Across to show only direct targets.<\/td><\/tr><tr><td>Search returns too many results<\/td><td>Use Similar To is enabled<\/td><td>Disable Use Similar To for exact-match searching.<\/td><\/tr><tr><td>Preference applies to wrong organization<\/td><td>Organization field set to a specific org instead of *<\/td><td>Set Organization to * for a tenant-wide preference.<\/td><\/tr><tr><td>Help popup lacks technical detail<\/td><td>Show Technical Information on Help is unchecked<\/td><td>Enable the option to view technical field information.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Next Steps<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Role window \u2013 review window and menu access tied to the current role.<\/li>\n\n\n\n<li>User\/Contact window \u2013 manage the user&#8217;s login and contact details.<\/li>\n\n\n\n<li>Preference window (system-level) \u2013 configure organization-wide default preferences.<\/li>\n\n\n\n<li>Change Role \u2013 switch tenant, organization or role context for the session.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>The User Preference window in iDempiere lets each user configure personal navigation, entry and display settings. Introduction The User Preference [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10,91],"tags":[],"class_list":["post-22500","post","type-post","status-publish","format-standard","hentry","category-idempiere-product","category-idempiere-general-rules"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22500","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=22500"}],"version-history":[{"count":0,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22500\/revisions"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=22500"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=22500"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=22500"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}