{"id":27569,"date":"2026-08-19T10:46:19","date_gmt":"2026-08-19T10:46:19","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=27569"},"modified":"2026-08-19T11:10:57","modified_gmt":"2026-08-19T11:10:57","slug":"how-to-configure-tenant-window-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-tenant-window-in-idempiere\/","title":{"rendered":"How To Configure Tenant Window in iDempiere"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">A Tenant in iDempiere is the highest level of a business \u2014 it usually represents one company. Every organization, user, and transaction belongs to one tenant, and data is never mixed between two different tenants.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The Tenant window is used to maintain a tenant that already exists \u2014 it is not used to create a new one.It is used by System Administrators across Retail, Distribution, Wholesale, and Service businesses to manage company identity, accounting defaults, hierarchies, and shared data across organizations.<\/p>\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>A tenant is always created using Initial Tenant Setup never by adding a row directly in this window.<\/li>\n\n\n\n<li>The Tenant window is only for maintaining a tenant that already exists.<\/li>\n\n\n\n<li>Data is never shared between two different tenants \u2014 sharing only happens between organizations inside the same tenant.<\/li>\n\n\n\n<li>The Material Policy (e.g. FiFo) decides which stock batch is used first across the whole company.<\/li>\n\n\n\n<li>The Calendar decides which accounting periods are Open (postings allowed) or Closed (postings blocked).<\/li>\n\n\n\n<li>Organization, Product, and Business Partner Trees group records for easier reporting and access control.<\/li>\n\n\n\n<li>A tenant is not a warehouse, branch, department, user, product, or business partner \u2014 those sit below it.<\/li>\n<\/ul>\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=\"246\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-ProcessFlow-1024x246.png\" alt=\"Tenthplanet Idempiere-General Rules-Tenant\" class=\"wp-image-27571\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-ProcessFlow-1024x246.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-ProcessFlow-300x72.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-ProcessFlow-768x185.png 768w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-ProcessFlow-1536x370.png 1536w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-ProcessFlow-2048x493.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Prerequisites<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Log in with System Administrator access \u2014 the Tenant window is only available at System level.<\/li>\n\n\n\n<li>The tenant must already exist, created earlier through &#8220;Initial Tenant Setup&#8221;.<\/li>\n\n\n\n<li>Have mail server details ready (host, port, username, password), if email will be configured.<\/li>\n\n\n\n<li>Know the accounting calendar and period structure the business will follow.<\/li>\n\n\n\n<li>Decide in advance which master data (Products, Business Partners) should be shared across organizations.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Navigation<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>System Administrator \u2192 Application Dictionary \u2192 Tenant<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Tenant: company identity, security, and mail server details.<\/li>\n\n\n\n<li>Tenant Info: accounting calendar, hierarchies, freight, and branding<\/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: Set Up the Tenant Tab<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This tab is required first because it defines the company&#8217;s identity and how it sends emails and secures logins.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Open the Tenant window, go to the Tenant tab, and fill in the Name, Search Key, Language, Material Policy, and mail\/security settings that apply to this company.<\/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>ABC Pvt Ltd<\/td><td>The name that identifies this tenant record \u2014 your company.<\/td><\/tr><tr><td>Search Key<\/td><td>ABC<\/td><td>A short unique code used to find this tenant quickly.<\/td><\/tr><tr><td>Name<\/td><td>ABC Pvt Ltd<\/td><td>The full company name shown throughout the system.<\/td><\/tr><tr><td>Active<\/td><td>Yes<\/td><td>Switches the tenant on or off. Inactive tenants should not be used for daily work.<\/td><\/tr><tr><td>Language<\/td><td>English<\/td><td>The default language used for this tenant&#8217;s screens and documents.<\/td><\/tr><tr><td>Material Policy<\/td><td>FiFo<\/td><td>Decides which stock batch is used first when goods are issued \u2014 oldest-in-first-out (FiFo) or similar.<\/td><\/tr><tr><td>Mail Host<\/td><td>smtp.company.com<\/td><td>The mail server address used to send system emails for this tenant.<\/td><\/tr><tr><td>SMTP Port<\/td><td>587<\/td><td>The port number used to connect to the mail server.<\/td><\/tr><tr><td>SMTP Authentication<\/td><td>Yes<\/td><td>Turn on if the mail server needs a username and password.<\/td><\/tr><tr><td>SMTP SSL\/TLS<\/td><td>Yes<\/td><td>Turn on if the mail server needs a secure, encrypted connection.<\/td><\/tr><tr><td>Request EMail<\/td><td>you @ company.org<\/td><td>The email address used to send and receive system requests, alerts, and notifications.<\/td><\/tr><tr><td>Password Policies<\/td><td>Standard Password Policy<\/td><td>The password rules every user of this tenant must follow to log in.<\/td><\/tr><tr><td>Authentication Type<\/td><td>Application \/ SSO<\/td><td>Decides how users are allowed to log in.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"672\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant.png\" alt=\"Tenthplanet Idempiere-General Rules-Tenant\" class=\"wp-image-27572\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-300x197.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-768x504.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"672\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-1.png\" alt=\"Tenthplanet Idempiere-General Rules-Tenant-1\" class=\"wp-image-27573\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-1.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-1-300x197.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-1-768x504.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 2: Set Up the Tenant Info Tab<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This tab is required to define accounting periods, reporting hierarchies, freight handling, and company branding.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Go to the Tenant Info tab. Set the Calendar, choose the Organization, Product, and Business Partner Trees, define Freight settings, and upload the Logo images.<\/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>Calendar<\/td><td>2026<\/td><td>The accounting calendar that defines periods (months) as open or closed for posting.<\/td><\/tr><tr><td>Organization Tree<\/td><td>ABC Retail \u2192 Regions \u2192 Orgs<\/td><td>The hierarchy that groups organizations for reporting and access control.<\/td><\/tr><tr><td>Product Tree<\/td><td>Electronics \u2192 Mobile, Laptop&#8230;<\/td><td>The hierarchy that groups products for easier reporting and browsing.<\/td><\/tr><tr><td>Business Partner Tree<\/td><td>Customers \/ Vendors<\/td><td>The hierarchy that groups business partners (customers and vendors) for reporting.<\/td><\/tr><tr><td>Freight Product<\/td><td>FREIGHT-001<\/td><td>The product used to represent freight\/shipping charges on a transaction.<\/td><\/tr><tr><td>Freight Charge<\/td><td>Freight Charge<\/td><td>A charge type used to represent freight cost, as an alternative to a product.<\/td><\/tr><tr><td>Logo \/ Logo Report \/ Logo Web<\/td><td>(image files)<\/td><td>The company logo shown on screens, printed reports, and the web store.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Once saved, these become the shared accounting and reporting defaults for every organization under this tenant.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"672\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-2.png\" alt=\"Tenthplanet Idempiere-General Rules-Tenant-2\" class=\"wp-image-27576\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-2.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-2-300x197.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-2-768x504.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"672\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-3.png\" alt=\"Tenthplanet Idempiere-General Rules-Tenant3\" class=\"wp-image-27577\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-3.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-3-300x197.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/08\/Tenthplanet-Idempiere-General-Rules-Tenant-3-768x504.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\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>A new tenant cannot be seen or used<\/td><td>It was created directly in the Tenant window instead of via Initial Tenant Setup<\/td><td>Always create new tenants using &#8220;Initial Tenant Setup&#8221;, then use the Tenant window only to maintain them.<\/td><\/tr><tr><td>Test EMail \/ system emails fail<\/td><td>Mail Host, Port, or login details are wrong<\/td><td>Check Mail Host, SMTP Port, Authentication, and SSL\/TLS settings, then test again.<\/td><\/tr><tr><td>Accounting entries cannot be posted for a month<\/td><td>The accounting period for that month is Closed in the Calendar<\/td><td>Open the relevant period in the Calendar if postings are genuinely required.<\/td><\/tr><tr><td>Reports group organizations, products, or partners incorrectly<\/td><td>The wrong tree is assigned, or the tree structure is incomplete<\/td><td>Review and correct the Organization, Product, or Business Partner Tree.<\/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>Set up Organizations under this tenant to represent branches, stores, or regions.<\/li>\n\n\n\n<li>Configure the Accounting Schema linked to the Calendar chosen here.<\/li>\n\n\n\n<li>Create Roles and Users to control who can access this tenant and its organizations.<\/li>\n\n\n\n<li>Set up Products and Business Partners, using Tenant Share where common data is needed.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>A Tenant in iDempiere is the highest level of a business \u2014 it usually represents one company. Every organization, user, [&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-27569","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\/27569","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=27569"}],"version-history":[{"count":1,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/27569\/revisions"}],"predecessor-version":[{"id":29822,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/27569\/revisions\/29822"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=27569"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=27569"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=27569"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}