Adding Subtypes to Account Addresses

Liferay DXP 2025.Q2+

Important

Currently, this feature is behind a release feature flag (LPD-43000). Read Release Feature Flags for more information.

In addition to billing and shipping address types, administrators can define and assign custom subtypes for account addresses. This supports complex B2B scenarios where accounts require multiple roles per address or integration with external systems like Enterprise Resource Planning (ERP) platforms.

To use subtypes, you must first create a picklist that defines the available options, then configure the system to use the picklist based on the address type (billing, shipping, or both). After configuration, you can assign subtypes to account addresses.

Creating a Picklist for Address Subtypes

Open the Global Menu (), go to the Control Panel tab, and click Picklist.
Click Add (), name the picklist (e.g., “Rebel Address Subtypes”), and click Save.
Click the picklist to open it.

Alternatively, click Actions () next to the picklist and select View.
Click Add Item () and add the following subtypes:
- Supply Depot
- Rebel Outpost
- Covert Delivery Point
- Command Center
- Droid Assembly Site
- Jedi Temple.
Copy the External Reference Code for the picklist. You need it to configure the subtypes in Instance Settings.

Tip

You can edit the ERC to use a more readable code and simplify the configuration process.
Click Save.

Important

Ensure users have the necessary permissions to view the picklist. To do this, click Actions () next to the picklist, select Permissions, and assign the View permission to the relevant users.

Configuring Address Subtype Picklists

Open the Global Menu (), go to the Control Panel tab, and click Instance Settings.
Select Accounts under Platform.
In the Account Address Subtype section, enter the External Reference Code for each applicable picklist:
- Billing Address Subtype Picklist External Reference Code: Picklist used for billing addresses.
- Shipping Address Subtype Picklist External Reference Code: Picklist used for shipping addresses.
- Billing and Shipping Address Subtype Picklist External Reference Code: Picklist shared by both types.
Note

The subtype drop-down is hidden until at least one subtype picklist is configured. Once configured, the drop-down appears but is grayed out for types without an associated subtype.

If you remove the ERCs and save the configuration, any previously saved subtype values remain, even if the drop-down no longer appears.
Click Save.

If you already have a picklist in place, click Update.

Assigning Subtypes

Once configured, subtypes appear when managing addresses in the Accounts application or during Commerce checkout.

From the Accounts Application

Open the Global Menu (), go to the Control Panel tab, and click Accounts.

You can also assign subtypes using the Account Management Widget.
Select an existing account or create one, then select the Addresses tab.
Click New or edit an existing address.
In the address form,
- Choose the Type (Billing, Shipping, or both).
- Select a Subtype from the drop-down.
Complete the form, including required fields (e.g., Name, Country, Street 1, City, Postal Code), and click Save.

During Commerce Checkout

You can also select subtypes during checkout in commerce-enabled pages.

For this example, use an accelerator to create a commerce site and assign subtypes during the checkout process:

Create a site using the Minium template. For more information on creating sites, see Adding a Site.

Alternatively, use the Commerce Classic Site Initializer.
Open the Global Menu () and select the site.
In the Catalog, add an item to the cart, click the Cart icon (), and click Submit to go to the Checkout page.
In the Shipping Address step, add or select an address and choose a subtype.

If Use Shipping Address as Billing Address is selected, the system applies the Billing and Shipping Address subtype. Changing this option during the process resets previously selected subtypes.

When using an existing address, a subtype may already be set in the Accounts application. If Use Shipping Address as Billing Address is selected and the saved address does not use the Billing and Shipping Address subtype, you’re prompted to select it. If the address already uses that subtype, no changes are required.
In the Billing Address step, add or select an address and choose a subtype.

Only billing subtypes are available at this step.

If you select an existing or add a new address without a defined subtype, you can select a subtype.