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.

Note

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.

  1. Open the Global Menu (Global Menu) and navigate to Commerce → Digital Sales Room Management.

  2. Click Rooms in the left sidebar.

  3. (Optional) Enter a room name in the search box to narrow the list.

  4. (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.

    The Status filter opens from the Filter button and shows the status in effect as a chip above the Rooms table.

Each room’s row ends with an Actions (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.

ActionWhat It DoesRoom StatusRequired Permissions
ArchiveCloses the room to buyers while keeping its content.ActiveUpdate
DeleteRemoves the room.Active or ArchivedDelete
DuplicateCopies the room to a new one.Active or ArchivedUpdate, plus permission to create rooms
EditOpens the room with its pages in edit mode.ActiveUpdate
RestoreReturns an archived room to the Active status.ArchivedUpdate
Room SettingsOpens the room’s General settings.ActiveUpdate
ShareOpens the Share dialog. Read-only on an archived room.Active or ArchivedUpdate
ViewOpens the room.Active or ArchivedView

With View permission alone, you see only View. Only instance administrators and the room site’s owner can view an archived room.

The Actions menu on an active room row lists every action an instance administrator can take.

Sharing a Room

Share a room to give buyers and colleagues access to it.

  1. In the Rooms list, click Actions (Actions) → Share. When you’re viewing the room, click Share in the room’s header instead.

    Before anyone is invited, the Share dialog shows an empty Email Addresses field, the Viewer role button, and an unset Access Valid Until date.

  2. Type an address in Email Addresses and press Enter or type a comma. Repeat for each person you’re inviting.

  3. (Optional) Choose the role for everyone in this invitation. The default role is Viewer. See Room Roles.

  4. (Optional) Set Access Valid Until for everyone in this invitation. See Setting Access Expiration.

  5. 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.

Note

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.

RoleDescription
Room CollaboratorUsers can manage pages and documents, add room comments, and share the room.
Content ContributorUsers can view room content, add comments, upload documents, and share the room.
ViewerUsers 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:

  1. In the Rooms list, click Actions (Actions) → Share.

  2. In the Who Has Access list, click Edit (Edit) on the person’s row.

  3. Click the date field and pick a date, then click the check mark to apply it. To discard the change, click the X (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.

Note

Access ends at the end of the expiration date in UTC. The person then no longer appears in the Who Has Access list.

Each member's row carries its own expiration date, role drop-down, and trash icon, with the expiring-soon dates flagged in orange.

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 (Trash).

Warning

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.

  1. In the Rooms list, click Actions (Actions) → Room Settings.

    The page title is the room’s name followed by Settings, for example Acme Deal Settings.

  2. Update these fields in the General section, the only section on this page. Name, External Reference Code, and Friendly URL are required.

    FieldDescription
    NameEnter a name for the room.
    External Reference CodeEnter a unique key for referencing the room from other systems.
    Friendly URLDetermines the URL for this room. Changing it changes the room’s address, so update any links that point to the old one.
    Site IDShows Liferay’s read-only identifier for the room’s site.
    Warning

    The 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.

    The Room Settings page has a single General section holding all four fields above Save and Cancel.

  3. 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.

  1. In the Rooms list, click Actions (Actions) → Duplicate.

    The Duplicate Digital Sales Room dialog lists the room’s documents, each with a checkbox.

    The dialog leaves every document unselected, so the copy includes only the ones you check.

  2. Select the documents to copy into the new room.

  3. 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

  1. In the Rooms list, click Actions (Actions) → Archive.

  2. 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.

The archived-room notice appears at the top of the room, above its header image and page tabs.

Restoring a Room

Restore a room to reopen it to its invited members.

  1. Set the Rooms list Status filter to Archived.

  2. Click Actions (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.

  1. In the Rooms list, click Actions (Actions) → Delete.

  2. 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.