Metadata About Locations

In an August 2019 article, I described the Outlook Places service and its role in surfacing information about locations in OWA’s calendar. Places use room mailboxes as the basic source of information about locations, and administrators can update metadata for each room mailbox to add geocoordinates and other information about room equipment to make what’s shown to end users more comprehensive and useful. For instance, if your organization equips conference rooms with Teams meeting devices, you can add that information to the room metadata.

At the time, I suggested that tenants should update room metadata because it was obvious that Microsoft would make more use of this information over time. Well, the pandemic intervened, and conference rooms haven’t had much use over the last year and a half, so that advice wasn’t as valuable as intended. And then Microsoft updated Outlook desktop to use the OWA room finder, which introduces the places information to desktop users for the first time.

Outlook and OWA’s Room Finder

Using OWA components in Outlook desktop is part of Microsoft’s One Outlook strategy to speed up the delivery of new functionality to end users by using common components across clients. Outlook desktop consumes OWA components using the Edge WebView2 Runtime. Sometimes this has unintended consequences, such as when credentials aren’t synchronized for Outlook and OWA and the Room Finder prompts for a sign-in unexpectedly (Figure 1). After you authenticate, the Room Finder pane attempts to display the full OWA client, which isn’t the best experience.

Room Finder prompts for authentication
Figure 1: Room Finder prompts for authentication

A comment posted to the article said that after Outlook picked up OWA’s room finder, “some meeting rooms are not displaying at all, despite being available.” This deserved some investigation about how the room finder decides which rooms to display when someone uses it to find a place to meet. As it happens, Microsoft documents how to configure the Room Finder, but it’s worth underlining some of the major points about how the Room Finder works.

Room Mailboxes and Workspaces

Room mailboxes (and optionally, workspaces) are schedulable locations for meetings. Room mailboxes represent conference rooms while workspaces, a variation of room mailboxes, represent other spaces where work gets done, anything from individual desks to areas used for presentations to small individual rooms used by people when they need some privacy. You can create a regular room mailbox through the Resources section of the Exchange admin center (EAC). The information collected there (Figure 2) allows the room mailbox to show up in the GAL and be scheduled as a meeting location.

Creating a new room mailbox in the EAC
Figure 2: Creating a new room mailbox in the EAC

However, the EAC doesn’t support the creation of a workspace. To set up a workspace, create a regular room mailbox and then use the Set-Mailbox cmdlet to set its type to workspace:

Set-Mailbox -Identity “Atrium Workspace 3” -Type Workspace

The EAC lists all room mailboxes (including those marked as workspaces) and you can manage the calendaring settings for the rooms there. You don’t need to assign licenses to room mailboxes.

Room Lists

Room lists are distribution lists for rooms and workspaces. Only room mailboxes can be members of distribution lists used for room lists. You can’t create a room list through the EAC, but you can create a regular distribution list and then update its properties to make it a room list (if the membership doesn’t contain anything but room mailboxes):

Set-DistributionGroup -Identity "Executive Rooms" -RoomList

You can’t manage room lists in the EAC and must use PowerShell to populate its membership with room mailboxes:

Add-DistributionGroupMember -Identity "Executive Rooms" -Member "Board Conference Room"

To see the set of available room lists, use this command:

Get-DistributionGroup -Filter {RecipientTypeDetails -eq "RoomList"} | Sort DisplayName | Format-Table DisplayName

Building 1 Rooms
Executive Rooms
HQ Rooms
San Francisco Rooms

Places Metadata

The basic calendaring settings for room mailboxes govern how people can scheduled them for meetings. The Room Finder depends on additional metadata to make good suggestions. The metadata includes the room equipment and its precise location (geo-coordinates). A separate arrangement to store and manage location metadata is needed because the mailbox properties don’t include this information. Microsoft could have expanded the property set, but this would affect all mailboxes rather than just room mailboxes. Almost 300 properties already exist for mailboxes, which is why the Get-ExoMailbox restricts the properties it returns to the bare minimum.

I cover how to use the Set-Place cmdlet to populate the location metadata in my original article. To help Room Finder make good suggestions, it’s important that every location includes information about its city, building, and floor.

Get-ExoMailbox -RecipientTypeDetails RoomMailbox | Sort DisplayName | Get-Place | Format-Table DisplayName, Building, Floor, City

DisplayName               Building   Floor City
-----------               --------   ----- ----
Atrium Workspace 1        HQ             2 Dublin
Atrium Workspace 2        HQ             2 Dublin
Atrium Workspace 3        HQ             2 Dublin
Board Conference Room     HQ             1 Dublin
Dublin Conference Room    Building 1     1 Dublin
Flayosc Conference Room   Building 1     2 Dublin
HQ Building Atrium        HQ             2 Dublin
Las Vegas Conference Room Building 1     2 Dublin
Room 101                  HQ             1 Dublin
Room 102                  HQ             1 Dublin
Room 103                  HQ             1 Dublin
Room 104                  HQ             1 Dublin
SF Room 101               Western HQ     1 San Francisco

Workplaces support floor plans to help people find somewhere they’ve booked. Floor plans are available in Outlook calendar and can be found in Microsoft Search by Bing. This is because floor plans and the locations the plans belong to are configured through the Microsoft Search section of the Microsoft 365 admin center. While useful, floor plans are an optional extra and don’t affect how the Room Finder works.

Updates to rooms, room lists, and room metadata can take up to 24 hours before the Conference Room assistant (a background process) runs to update the data used by Room Finder. You can’t affect when the assistant runs and be patient for changes to show up for users.

Microsoft Platform Migration Planning and Consolidation

Simplify migration planning, overcome migration challenges, and finish projects faster while minimizing the costs, risks and disruptions to users.

Room Finder Suggestions

To make suggestions, Room Finder checks for the last building selected by the user (on the basis that they probably want to reserve rooms in the same building). If the user never selected a building, Room Finder shows the first 20 rooms it finds in the tenant (Figure 3). These rooms are not specific to a location. Workspaces are not included in the list.

Room Finder starts with no building selected
Figure 3: Room Finder starts with no building selected

The user can apply a filter to create a more refined list. The most important choice is the building. When they select a building, the selection is for a room list. To help, Room Finder shows cities in a drop-down list. Room Finder creates the list of cities from the City property for locations updated by Set-Place. Selecting a city reveals room lists with rooms in the selected city and selecting a room list reveals the individual rooms (Figure 4).

Selecting a room list for a city
Figure 4: Selecting a room list for a city

The Type field allows users to choose between the conference rooms and workspaces in a room list. Room Finder only shows the Type field when workspaces are available.

When it lists rooms, Room Finder shows details for each room including its availability and features. Room features are indicated using icons (Figure 5), including:

  • Audio.
  • Video conferencing.
  • Display screen.
  • Wheelchair accessibility.
Room Finder displays room characteristics
Figure 5: Room Finder displays room characteristics

Room Mailbox Features

Users can search for a conference room by applying a filter to identify rooms with certain features (Figure 6). The last two features listed are custom tags created for rooms using the Set-Place cmdlet. While the examples I’ve used describe the view from a room, more productive uses would be to indicate if a room needs a special badge for access, can host a Teams online meeting, or can be catered for meals.

Filtering rooms by equipment
Figure 6: Filtering rooms by equipment

Room features can be updated through EAC through the Additional information section of the mailbox’s properties (Figure 7).

Updating the equipment information for a room mailbox
Figure 7: Updating the equipment information for a room mailbox

Here’s what the data looks like when viewed through PowerShell:

Get-DistributionGroupMember -Identity "Building 1 Rooms" | Get-Place | Format-List DisplayName, City, AudioDeviceName, VideoDeviceName, DisplayDeviceName, IsWheelChairAccessible, Tags

DisplayName            : Dublin Conference Room
City                   : Dublin
AudioDeviceName        : PolyCom
VideoDeviceName        : InFocus WXGA Projector
DisplayDeviceName      : Samsung OLED 55"
IsWheelChairAccessible : False
Tags                   : {Amazing View}

DisplayName            : Flayosc Conference Room
City                   : Dublin
AudioDeviceName        : Polycom
VideoDeviceName        : Surface Hub 25
DisplayDeviceName      : Samsung OLED60
IsWheelChairAccessible : True
Tags                   : {Great view over the River Liffey}

Workspaces don’t support features, possibly because many workspaces are small and not equipped in the same way as conference rooms often are.

Workspace booking is supported by Outlook mobile clients. However, when you create a “normal” event with Outlook mobile, it uses Bing maps for its location rather than Outlook places.

Deprecated Equipment and Configurations

Exchange on-premises servers don’t use Outlook places. Instead, they are limited to room and equipment mailboxes. Equipment mailboxes represent items which might belong to conference rooms (like VCRs, when we used VCRs) or can be moveable. Equipment mailboxes still exist in Exchange Online, but the information which can be defined for a location now makes them less useful than in the past. However, if your organization has equipment mailboxes, there’s no reason not to use them by scheduling them for meetings.

What is deprecated are the old resource configuration cmdlets (Set-ResourceConfig and Get-ResourceConfig) to define custom properties for room and equipment mailboxes. Outlook places ignoIt’sres this configuration data.

Important to Configure Your Places

The Room Finder can’t work properly if location data is missing or inaccurate for room mailboxes (including the location metadata) or room lists aren’t in place. Once configured, room mailboxes make the Room Finder much more useful. And the best thing is that room mailboxes are low maintenance. They should not take much management unless their equipment changes, so an update might be needed every couple of years or so.

About the Author

Tony Redmond

Tony Redmond has written thousands of articles about Microsoft technology since 1996. He is the lead author for the Office 365 for IT Pros eBook, the only book covering Office 365 that is updated monthly to keep pace with change in the cloud. Apart from contributing to, Tony also writes at to support the development of the eBook. He has been a Microsoft MVP since 2004.


  1. Daniel

    Hello Tony,

    I have an issue with my Room List. Although each room’s cities all are populated correctly in each resource, their locations all show under one location. We just have one list currently containing all conference rooms. Is there a way to change the location of a room list? Or would it be better to delete that list and recreate each city as it’s own room list?

  2. Patrick

    Hi Tony,

    Is it possible to programmatically pull a list of available rooms with filter, without using room finder?

    1. Avatar photo
      Tony Redmond

      Get-ExoMailbox -RecipientTypeDetails RoomMailbox -ResultSize Unlimited

  3. Stuart Tweddle

    Thanks for the write up Tony, it has come in useful a few times over the last 6 months!
    I’ve come to create a new room today and I’ve hit an issue. Created the room in exchange/admin centre and when trying to add the room to a room list, I get a “object couldn’t be found” error. If I do get-mailbox, it finds it and I can see all its properties. I can’t seem to add any existing rooms to a list either. Any ideas?

    1. Stuart Tweddle

      Problem found. Human error mixing up the room and room list name in the command!

  4. Richard

    Wow, what a nice article!

    I have a problem though.
    Ik have 4 cities:


    In every city I have a distributiongroep where all local rooms are located.

    But in Rotterdam I have an extra distributionsgroup that has all rooms (from all cities).
    It’s placed under Rotterdam (I don’t know why), and I want to place it one level higher (if possible).

    Do you know what to do?

    1. Avatar photo
      Tony Redmond

      Why can’t you remove the extra DL from the Rotterdam room list?

      If it’s a room list distribution list, it can be shown in Room Finder, but only on the same level as the other city room lists.

      1. Richard

        When I make a room list distribution list, the list will reside under the city where the most rooms are part of. I have no control over that.
        However, I would like a roomlist that covers all cities at once.

        But I think it’s not possible…

  5. Aneesh Raghavan

    Thank you for the article. Is there a way we can remove a place from Room Finder ?

    We have few places without any rooms under it and would like to cleanup but could not find a way because I don’t see a Remove-Place command available

  6. James

    Hi Tony,
    While searching for an answer to a problem I am seeing with Room Finder, I stumbled onto your article. You seem to know the process very well, so I thought I would run my problem by you.
    I have everything configured and after waiting for a few days, Room Finder is finding the available rooms. But, when I select a room, it puts the room’s email address in the “Required” field. It does not put the room into the Location field, so when you click on Send, you get a warning stating that you have not selected a location.
    I have used Get-Place -Identity $_.Name | Format-List
    to get a list of rooms. I noticed that the Localities field is not populated. Could this be what is preventing the room from going in to the Location field? If so, how do I get the Localities to populate correctly?
    I appreciate any insight you might have.

    1. Avatar photo
      Tony Redmond

      looking at my rooms, I see that localities is populated with the name of the rooms list that rooms feature in. Do you have rooms lists set up and populated with room mailboxes?

  7. Japhet

    Hi Tony,

    Really good article. I have a question. We have been using workspaces for over a year. All the problems we faced in the beginning are now resolved. There is one thing the has happened three times where the attributes for Floor, Building, and Features are being wiped out from metadata and could not find the root cause. We recently opened a ticket with Microsoft but they cannot find anything wrong. Have you heard anything like this.

    1. Avatar photo
      Tony Redmond

      Nope. Heard nothing like it, but because Microsoft is working on their Places solution, it doesn’t surprise me if stuff happens… The only way to resolve these kind of issues is to report them to Microsoft support.

  8. Matt

    For some reason, the list of cities I have created isn’t appearing on Outlook room finder, but it is appearing on MS Teams and Outlook app on the iphone.
    On the desktop Outlook and OWA, I have the manually enter the city name in order for the rooms to appear. We have ensure the place has been set to the respective city as well.
    Do you know what is causing this?

    1. Avatar photo
      Tony Redmond

      Obviously the Outlook desktop client is not reading the information from the service in the same way as the other two clients do. Are you using the latest software?

  9. MRD

    Is the text you add to the AudioDeviceName, VideoDeviceName, and DisplayDeviceName attributes searchable in Room Finder? Where does this text appear in the user interface, if at all?

    1. Avatar photo
      Tony Redmond

      There’s a features section in Room Finder that allows you to search for rooms equipped with something specific, like a video. Search doesn’t extend to a particular brand or model.

  10. Steven

    Thanks for this article. However myself, like many others, can’t seem to get this working within Outlook’s Room Finder. I have everything configured seemingly correctly, and the Room finder within Teams works as expected, it prompts me with a list of the Room Lists, and then each list correctly displays the rooms in that list. However in Outlook there is no room list option, purely a ‘building’ dropdown which displays nothing. What myself and others have found is that if you manually type the name of a room list into the building field (and the UI doesn’t even indicate you can type into it, it makes it appear to be a dropdown list with nothing inside) then it does actually then display the expected rooms, but it’s a terrible and non-intuitive way to do it, and requires the users to know the name of a room list in order to manually type it. Do you know of a fix for this?

  11. Rizvi

    how to add new room list into specific city in room finder

    1. Avatar photo
      Tony Redmond

      Have you looked up the documentation for how to create a new room list?

      1. Rizwan

        Thank you for your reply.

        Yes created the room list with below
        new-distributiongroup -name -Roomlist
        It creates the room list but how i am not sure how we can place that to specific city or can we create a new one and place it their.

        Is it depend on city field of rooms added to that room list and accordingly the list add to respective city?
        Sorry i am new to exchange and looking forward to your help!

        1. Avatar photo
          Tony Redmond

          A room list is a distribution list composed of room mailboxes. For a new city, you’d create a room list for the City (let’s say it’s called something like “Sydney Rooms”) and then add all the room mailboxes representing conference rooms located in that city as members of the distribution list.

          1. William

            Hi Tony – I’ve just set up the above (Set up a new DL with the prerequisite -RoomList tag after the name) and assigned the relevant existing rooms to the newly created DL.

            Is there a generally accepted time that needs to pass before they appear in the Room Finder feature in Outlook (or OWA)? I’ve read anywhere between 24-72 hours but was just wondering if you knew more.


          2. Avatar photo
            Tony Redmond

            My experience is that the process can take several days.

  12. JME

    Hi Tony,
    Excellent article, thank you for sharing. I am currently reviewing room lists to see whether it has a place within our business.. I like the idea of it as it modernizes the directory with additional features.

    From the point of creation, do Room Lists (with members) also take up to 24 hours to reflect in either outlook online/desktop Outlook clients? i.e. searchable / selectable within ‘Room Finder’?

    Thank you in advance.

    1. Avatar photo
      Tony Redmond

      It certainly takes time for changes made to rooms and room lists to replicate across Microsoft 365. This is probably acceptable because you don’t tend to change these objects very often, but expect that things might take a few days before new data appears to users.

  13. Gary Fanning

    Hi Tony
    Does OWA need to be enabled for the user for this to work?
    We have OWA disabled in our organization.

    1. Avatar photo
      Tony Redmond

      I just ran a quick test to disable OWA for my own account:

      Set-CasMailbox -OWaEnabled $False
      Waited for 20 minutes
      Scheduled meeting from Outlook desktop
      Attempted to pick a room and failed – utterly.

      It looks as if you do need to enable OWA for room finder to work.

      1. Gary Fanning

        Thanks for confirming that, Tony.
        Sorry for the late response

  14. Todd

    The Room Mailbox “additional information” populates the icons next to the room in Room Finder but doesn’t display what info was entered into the fields. Besides using PowerShell to add -ResourcePropertySchema and -ResourceCustom to each mailbox. Is there way to see this information? Or is this just an incomplete development from Microsoft?

  15. Felix

    Hi Tony – we have his feature since a longer time. I have now noticed that the room finder can only display 2 months into the future for series appointments. All later dates appear as “unknown”. Can this be configured? It happens in Outlook Client and Web.

    1. Avatar photo
      Tony Redmond

      I don’t know how this period is configured. I would file a support call with Microsoft and ask them.

      1. Felix

        Confirmed by Microsoft, there’s a 62 day limit.
        Roomfinder can take a maximum of 2 months into the future for serial appointments.

  16. Dan

    We have been using Room Finder for a while now and works great. Having one small issue that has arisen in last couple of weeks. We have around 20 travel cubes that we have setup in Room Finder and about half of them are now showing status “unknown” instead of “available”. They will still auto accept meeting and then status will change to “unavailable” as it should. HAs anyone ran into this issue?

    1. Avatar photo
      Tony Redmond

      I sense the opportunity to talk to a Microsoft support professional in your future…

  17. Deepak

    Hello Tony. Our Room Lists work just fine but we have a problem with Cities. All Room Mailboxes have place set to Newark, but the Room Finder shows NewarkJ in the cities list instead of Newark. I tried to look up everywhere but NewarkJ is nowhere to be seen. How do we correct it?

    1. Avatar photo
      Tony Redmond

      I’d go to Microsoft support and ask them to check out your tenant. I obviously can’t connect to it, and without sight of the data, it’s impossible for me to say.

  18. Vrushal Salunke

    I have done above settings but still the when I click on Room finder it shows nothing.

    1. Avatar photo
      Tony Redmond

      How long did you wait? It can take a while before the settings appear in Room Finder. If they don’t show up within a day or so, report the issue to Microsoft and have them investigate what’s happening in your tenant.

  19. Tom

    Does anyone know if you can remove entries from the Suggestions tab, without deleting the room or room list?
    Room has been removed from the room list but still appearing.

    1. Avatar photo
      Tony Redmond

      It takes a little time before updates ripple their way into full visibility. Microsoft was having some difficulties with the Room service, but I believe those problems are now resolved.

  20. Jakub

    In my case it was modified GAL that didn’t display roomlists (why would you want to display that in user’s addressbook?)
    No roomlists in GAL = no roomlists in room finder.

  21. ned

    when we enable -AutomateProcessing AutoAccept on a workspace room mailbox, it accepts the meetings, but as FREE and not busy. When we manually accept the meetings, it occurs as busy.

    When workspace resource-type mailboxes are booked, it automatically processes the accepted invitation as FREE. And this remains FREE until the invited user manually accepts it and then it shows as BUSY.

    This behavior is quite different for the non-workspace resource mailbox which processes the accepted invitation as BUSY.

    Why is this so?

    1. Matt

      Hello Ned, I’m facing the same problem. Have you found a solution ?

  22. M

    New Room Finder vs. Old Room Finder issues with the New one..

    My Set-Place command always returns Encountered an internal server error.
    Even though a Get-Place for the same RoomMailbox returns the value set.

    In Teams the Room Finder works as expected – Select my two Places (RoomLists) with my RoomMailboxes are member of… In Outlook and OWA – Room Finder does not show any Buildings / Locations.

    Workaround for now:
    Revert to the old View:

    Anyone had the same issues?

  23. Tony

    Prior to the new Room Finder behavior, all we have are Room Lists. Are Room Lists still being used as a filter OR they are now called Buildings?

    1. Avatar photo
      Tony Redmond

      Room lists are used to identify sets of rooms in buildings within locations. At least, that’s the way it seems to work to me.

  24. Alex

    Hi Tony! This was a really good thorough guide, and it helped lots. One thing I am struggling with though is after about a week, my room mailboxes have stopped accepting the “set-place” commands! They just throw a task exception!

    It worked earlier in the week no problem, but it looks a bit silly now with only half the meeting rooms having full info, and the others just having their cities.

    The error is the following:
    “Encountered an internal server error.
    + CategoryInfo : NotSpecified: (:) [Set-Place], TaskException
    + FullyQualifiedErrorId : [Server=xxxxxxxxxxx,RequestId=xxxxxxxxxx,TimeStamp=28.03.2022 07:12:41] [FailureCategory=Cmdlet-TaskException] Microsoft.Exchange.Management.RecipientTasks.SetPlace
    + PSComputerName :”

    Do you have any idea what the problem could be, if you’ve encountered it before?

    Many thanks!

    1. Avatar photo
      Tony Redmond

      Looks like it’s a bug that has crept it (I get the same error when I run Set-Place). Please report the issue to Microsoft support so that it gets logged and an engineer is assigned to investigate.

      1. Dominik

        We seem to have the same issue. Is there any news from MS already?

          1. Nikhita Rawal

            I faced the same issue and raised an incident and here are the details about it –

            SI EX354548 -Admins are unable to use the Set-place cmdlet to set values for Exchange Online meetings via PowerShell

            Status: Service restored

            More info: The values set via the Set-place cmdlet were used by the Room Finder in the Outlook desktop client and web clients to search for rooms when scheduling meetings.

            Final status: The fix has completed deployment to the affected environment, and we’ve confirmed with previously affected admins that impact is now remediated.

            Scope of impact: Any admin attempting to use the Set-place cmdlet in PowerShell to set values for Exchange Online meetings were impacted.

            Start time: Sunday, March 27, 2022, 2:30 PM (9:00 AM UTC) End time: Tuesday, April 12, 2022, 3:30 AM (4/11/2022, 10:00 PM UTC) \

            Root cause: A recent update intended to improve the code pathway responsible for recognizing whether rooms are enabled for Microsoft Teams Rooms devices contained a regression that resulted in a Set-place cmdlet error.

          2. Avatar photo
            Tony Redmond

            Terrific. Thanks for letting us know.

  25. Chris

    Thanks for this detailed explanation Tony!

    One question for me, I’m currently updating our list of rooms in our office. A few of the rooms need to be removed and some renamed. I’ve removed the rooms from the distribution list configured for what floors they are on, made all the name changes to the Active Directory account (our AD is still On Prem) and also made changes the room mailbox accounts on EAC. Ticked the box to hide from address list etc.

    I’ve found that the rooms no longer appear in the GAL when searching for them but they all still appear in the room finder, both on the Outlook client and OWA.

    Is there another area we need to make the same changes to for something like this?

    1. Avatar photo
      Tony Redmond

      I don’t know and can’t say because your configuration is invisible to me. You could file a support incident with Microsoft and ask them to check things out – the support people can access the data (I can’t).

      1. Chris

        Ok no worries, thanks for replying. Will see check with MS support.


  26. Guru

    ‘Capacity’ & ‘floor’ filters are greyed out in room finder – both in OWA & outlook client.

    1. Avatar photo
      Tony Redmond

      Are these properties defined for the rooms? If they are, you should file a support call with Microsoft and ask them to check your tenant. I obviously have no access to your data.

  27. MHR

    How long does it take for the metadata information to update? I have updated it more than 24 hours ago and it is still not appearing.

    1. Avatar photo
      Tony Redmond

      Welcome to the cloud. Things take their own time and you can’t force anything to happen…

  28. Thomas Guldberg

    Thx Tony!

    As usual you are able to communicate the information that MS cannot. I have been pulling my hair since some meeting rooms stopped showing up in Room Finder while still being available in the All Rooms address list. The really tricky part was that it worked for some users and not others. That of course turned out to be different Outlook versions.

  29. Mike

    Hi. Can I configure the location metadata without entering geolocation? Does not seem to work for me

Leave a Reply