Managing Rooms
Liferay DXP 2026.Q3+
Manage existing Digital Sales Rooms from the Rooms list in the Digital Sales Room Launchpad. Use a room’s Actions menu to share it, change its settings, duplicate it, archive it, restore it, or delete it.
You must activate the Digital Sales Room before managing rooms. To create your first room, see Creating Rooms.
Viewing and Filtering Rooms
Use the Rooms list to find a room and to switch between active and archived ones. Archived rooms stay in this list instead of moving to a separate view.
-
Open the Global Menu (
) and navigate to Commerce → Digital Sales Room Management. -
Click Rooms in the left sidebar.
-
(Optional) Enter a room name in the search box to narrow the list.
-
(Optional) Set the Status filter to Active or Archived, then click Show Results. The filter takes one status at a time and defaults to Active, so archived rooms stay hidden until you switch it.

Each room’s row ends with an Actions (
) button, which opens the menu the tasks below start from.
Room Actions
What you can do with a room depends on its status and your permissions.
| Action | What It Does | Room Status | Required Permissions |
|---|---|---|---|
| Archive | Closes the room to buyers while keeping its content. | Active | Update |
| Delete | Removes the room. | Active or Archived | Delete |
| Duplicate | Copies the room to a new one. | Active or Archived | Update, plus permission to create rooms |
| Edit | Opens the room with its pages in edit mode. | Active | Update |
| Restore | Returns an archived room to the Active status. | Archived | Update |
| Room Settings | Opens the room’s General settings. | Active | Update |
| Share | Opens the Share dialog. Read-only on an archived room. | Active or Archived | Update |
| View | Opens the room. | Active or Archived | View |
With View permission alone, you see only View. Only instance administrators and the room site’s owner can view an archived room.

Sharing a Room
Share a room to give buyers and colleagues access to it.
-
In the Rooms list, click Actions (
) → Share. When you’re viewing the room, click Share in the room’s header instead.
-
Type an address in Email Addresses and press Enter or type a comma. Repeat for each person you’re inviting.
-
(Optional) Choose the role for everyone in this invitation. The default role is Viewer. See Room Roles.
-
(Optional) Set Access Valid Until for everyone in this invitation. See Setting Access Expiration.
-
Click Invite.
A message confirms the invitation. Each invitee receives an email invitation.
An invitation expires 48 hours after you send it. Send a new invitation if the recipient doesn’t accept in time.
One role and one expiration date apply to the whole invitation. To give people different roles or dates, send separate invitations, or change them afterward in the Who Has Access list.
An invitee who already has a Liferay account joins the room’s account as soon as you send the invitation. An invitee without a Liferay account joins the room’s account when they accept the email invitation.
Room Roles
The Share dialog offers three roles. Assign the one that matches what the person must do in the room.
| Role | Description |
|---|---|
| Room Collaborator | Users can manage pages and documents, add room comments, and share the room. |
| Content Contributor | Users can view room content, add comments, upload documents, and share the room. |
| Viewer | Users can view documents and add comments, but cannot upload documents. |
Buyers are usually Viewers. Assign Content Contributor when they must upload files. Assign Room Collaborator to users who build the room’s pages. All three roles can post and reply in Room Comments.
Room Collaborators and Content Contributors can assign the Content Contributor and Viewer roles. Only the room site’s administrator or owner can assign the Room Collaborator role. Everyone else sees only Content Contributor and Viewer in the role list.
The room’s Owner is the person who created it. The Who Has Access list shows the Owner separately.
Setting Access Expiration
Set an expiration date when someone needs access for a limited time, such as a reviewer brought in for a single stage. The date applies to one person in one room. When you invite someone without an expiration date, their row reads No Expiration, and their access ends only when you remove them, archive the room, or delete it.
You set Access Valid Until when inviting someone. To change it afterward:
-
In the Rooms list, click Actions (
) → Share. -
In the Who Has Access list, click Edit (
) on the person’s row. -
Click the date field and pick a date, then click the check mark to apply it. To discard the change, click the X (
) instead.The row shows the new date. To remove an expiration, clear the date field and apply the change. The row then reads No Expiration.
When someone’s access expires within seven days, their row shows a warning label and the dialog displays a banner, for example 2 users have access expiring within 7 days. Both appear in the Share dialog, so they reach only the members who can share the room. Viewers have no Share button.
Access ends at the end of the expiration date in UTC. The person then no longer appears in the Who Has Access list.

Changing Roles and Removing Access
Use the Who Has Access list to change a member’s role or remove them from the room. Each person’s row has a drop-down showing their current role and a trash icon.
-
To change a role, select a new one from the drop-down. It applies immediately.
-
To remove someone, click the trash icon (
).
Neither action asks for confirmation. Check the row before you change a role or click the trash icon.
You can change or remove people you invited, plus anyone whose current role you’re able to assign. The Owner can’t be changed.
Configuring Room Settings
Change a room’s settings to rename it or to update the identifiers other systems use to find it.
-
In the Rooms list, click Actions (
) → Room Settings.The page title is the room’s name followed by Settings, for example Acme Deal Settings.
-
Update these fields in the General section, the only section on this page. Name, External Reference Code, and Friendly URL are required.
Field Description Name Enter a name for the room. External Reference Code Enter a unique key for referencing the room from other systems. Friendly URL Determines the URL for this room. Changing it changes the room’s address, so update any links that point to the old one. Site ID Shows Liferay’s read-only identifier for the room’s site. WarningThe External Reference Code is the key other systems use to find this room. Changing an existing value changes what those systems must send to reach the room. Confirm the new value with whoever maintains those systems before you save.

-
Click Save.
Your changes are saved and you return to the Rooms list. To discard them instead, click Cancel.
Duplicating a Room
Duplicate a room to reuse its structure for another deal. The source room is unchanged.
-
In the Rooms list, click Actions (
) → Duplicate.The Duplicate Digital Sales Room dialog lists the room’s documents, each with a checkbox.

-
Select the documents to copy into the new room.
-
Click Duplicate.
Creating the copy takes a few moments. The dialog closes when the new room is ready.
You can duplicate a room you created, and instance administrators can duplicate any room, including archived ones. Duplicated rooms are created with the Active status.
The copy includes the room’s pages and the documents you selected. Comments and the room’s members don’t carry over. Share the new room to add members to it.
Archiving and Restoring Rooms
Archive a room when the deal closes and you want to keep its content without leaving the room open to buyers. Archiving is reversible.
Archiving a Room
-
In the Rooms list, click Actions (
) → Archive. -
Click Archive in the confirmation dialog, which reads, “Are you sure you want to archive this digital sales room? It will no longer be available to customers, but you can restore it later.”
The room keeps its place in the Rooms list under the Archived status. To see it, set the Status filter to Archived.
Archiving changes the room in these ways:
-
An informational notice at the top of the room reads, “This digital sales room is archived. New comments cannot be added, and it can no longer be shared.”
-
Access narrows to instance administrators and the site’s owner. Other invited members who visit the room are redirected away from it.
-
The Share dialog becomes read-only for everyone, instance administrators included. You can see who has access, but you can’t invite anyone, change roles or expiration dates, or remove members.
-
Uploading documents is closed. The New button no longer appears in the Documents view, except for instance administrators.

Restoring a Room
Restore a room to reopen it to its invited members.
-
Set the Rooms list Status filter to Archived.
-
Click Actions (
) → Restore.
The room returns to the Active status and leaves the Archived list. To see it, set the Status filter to Active. Invited members can reach it again.
Deleting a Room
Delete a room when you no longer need the room or anything in it. Deletion is permanent: it removes the room’s documents and revokes every member’s access. To close a room to buyers while keeping its content, archive it instead.
-
In the Rooms list, click Actions (
) → Delete. -
Click Delete in the Delete Digital Sales Room dialog, which reads, “Are you sure you want to delete this digital sales room?”
The room disappears from the Rooms list.