Skip to main content
Sign in
Español Français Italiano
Menu

Homes & Villas by Marriott Bonvoy: Channel Overview

Robert
  • Updated

Learn how the Homes & Villas by Marriott Bonvoy channel works with Hostaway, including setup requirements, listing distribution, and important integration considerations.

 

The Homes and Villas by Marriott (HVMB) channel is available to Hostaway customers who meet Marriott's eligibility requirements.
 

We invite customers to join the program if they are already listed on HVMB or wish to list their property on the new channel.

  • Please keep in mind that currently, you must have a minimum of 35 listings to be eligible for the program. Since this is a channel requirement, you can contact them to find out the exact number of listings you need.
  • In addition, HVMB does not support multi-unit listings.
  • Guests can use inquiries, but Hostaway will not receive them.
    • The host will receive an email with the inquiry, and the communication must be managed directly via email.
    • HVMB can turn off the inquiry option for some clients if this becomes an issue for them.

 

Connection Process

  1. Apply to HVMB: Fill out the interest form on the HVMB website, selecting Hostaway as your Property Management System (PMS)
  2. HVMB's Evaluation: HVMB will review your submission and contact you by email within 3 business days to outline its onboarding and evaluation process
  3. Receive HMC ID: If your application is approved, and you move forward with onboarding to HVMB, they will provide you with your "HMC ID". This is specific to your company and is needed for the connection.
  4. Activate in Hostaway: Contact Hostaway Support and share your HMC ID. This can be done via this form. Hostaway Support will then activate the HVMB export feature on your account
  5. Final Configuration: Once activated, you can enter your HMC ID in your Hostaway dashboard under Channel Manager > Channels > Homes & Villas > Configure > Settings
  6. After saving, the channel will become active, and you can begin exporting your listings to HVMB.

 

Setting your listings ready for Export

1. Under menu listings, click on the edit button per listing-channel-specific and fill in an HVMB listing title

2. Once HVMB has approved you, you will receive a so-called HMC ID

4. You will be required to navigate to Channel Manager > Channels > Homes & Villas > Configure > Settings and enter the HMC ID:
 

mceclip0.png

 

Once done, the channel will appear as active:
 

mceclip1.png

 

5. Then, within Channel Manager > Channels > Homes & Villas > Configurations, you can find the export button for each listing. When clicked, some validations are done to make sure that the Listing will pass the minimum requirements from HVMB:
 

mceclip2.png

 

Each property listing must include:​

  • Unique Property Name (min 8 characters, max 255)​

  • Listing ID (provided by the HVMI Integration team)​

  • HMC ID (provided by the HVMI integration team)​

  • Accurate property address​

  • Property Description 

  • Number of “rooms” > 0​

  • Bedroom Arrangements are present (i.e., Bedroom with 1 Queen Bed, Living Room with Sleeper Sofa)​

  • A minimum of 6 pictures with a minimum res of 500 x 800 (we recommend 20 pics) ​

  • A minimum of 5 Amenities  ​

  • Cancellation policy (14, 30, 60 or 90 days)​

  • At least 3 days of consecutive availability and nightly base pricing over the next 365 days​

6. Once exported, within 72 hours on business days, the HVMB team will review its content before going live. If everything goes well, the listing will go from Off to Pending / On  status, since HVMB has to approve (and sometimes curate) the listing:
 

mceclip3.png

 

When a listing is finally connected to HVMB (status On) Hostaway will sync any changes from listings every 3 hours. Active listings will have the option to add a markup when clicking on Settings, and also to unpublish these listings by setting them to Off:

 

mceclip4.png

 

If your properties already exist in HVMB and you are migrating from another PMS and/or Connectivity Provider to Hostaway

Here are the steps required if you are migrating to Hostaway from another PMS or Connectivity Provider and you already have an HMC ID:

  1. HVMB needs to be notified of an upcoming system switch, whether it is a PMS or CP
  2. HVMB will send you a mapping sheet that links the new listing ID in Hostaway to the existing HVMB Listing ID. You will be required to complete it accordingly and send the updated mapping sheet to them
  3. Once HVMB completes the mapping, you will be notified that you can connect your listings through Hostaway
    • If you are ONLY switching the PMS, a new HMC ID is not needed from HVMB
    • If you are switching the channel manager, a new HMC ID is needed and will be provided
       
  4. Once the listings are pushed to Homes & Villas through the new connection, their team will check that all content requirements are met and do a test booking for you to review and approve
  5. After a test booking is confirmed and there are no content issues, their team will re-publish the listings as live on their site

Note: No listings should be pushed through to Homes & Villas until after the HVMB team confirms that the mapping is completed. If the push is done before the mapping, duplicate listings will be created

 

Activating/Deactivating properties in HVMB (that are connected to Hostaway)

It is possible to deactivate or activate properties in HVMB from Hostaway; however, this action can only be performed by the Hostaway Support team. Please reach out to Support if any of these actions are needed.

 

Please remember

  1. You should not delete listings that are being exported to HVMB from the Hostaway platform.
  2. Export may take some time, within 72 hours on business days
  3. If you have any questions or findings before, during, or after setting up HVMB as a channel, we would be interested to hear from you by submitting a request

 

Current Mapping Limitations

The Hostaway-HVMB integration currently has limitations in how certain data fields are mapped between the two platforms. These limitations may affect:

  • Fee options - Not all fee types may be transmitted to HVMB
    Fees Exported to HVMB
    • Supported Fees:
      • Nightly Rate (Base Price)
      • Cleaning Fee
      • Damage Deposit (in some cases)
      • Markup (as a percentage or flat amount, applied to the nightly rate)

        Captura de pantalla 2025-10-27 a las 15.58.59.png
         
    • NOT Supported:
    • Other custom or mandatory fees (e.g., admin, resort, laundry, amenities, management, booking fees) are NOT exported to HVMB. These fees, even if set up in Hostaway’s “Prices & Fees” section, will not be transmitted to HVMB, and there is currently no way to add them directly on HVMB's side either. This is a known limitation of the current API connection between Hostaway and HVMB. The most common workaround is to increase the markup to recoup these costs, but this does not provide a line-item breakdown for guests and can affect pricing competitiveness
  • Content fields - Some property description fields may have restricted mapping 
  • Content Fields Exported to HVMB
  • Each property listing must include the following fields for successful export:
     
    • Unique Property Name (8–255 characters)
    • Accurate Property Address
    • Property Description
    • Number of Rooms (>0)
    • Bedroom Arrangements (e.g., “Bedroom with 1 Queen Bed”)
    • Minimum 6 Photos (at least 500x800 pixels; 20 recommended)
    • Minimum 5 Amenities
    • Cancellation Policy (must be 14, 30, 60, or 90 days)
    • At least 3 consecutive days of availability and nightly base pricing for the next 365 days
    • Listing ID (provided by Hostaway)
    • HMC ID (provided by HVMB)
       
  • Amenities - Certain amenity categories may not be fully mapped
    Amenities Exported to HVMB
    • Minimum Requirement: Each listing must have at least 5 amenities selected in Hostaway to be eligible for export.
    • Exported Fields: The amenities you select in Hostaway are exported to HVMB, but only those that are supported by HVMB's platform will be displayed. There is no exhaustive public list, but standard amenities (WiFi, air conditioning, kitchen, etc.) are typically supported

      Captura de pantalla 2025-10-27 a las 15.43.18.png

 

Important Clarification

These limitations are related to the current integration mapping between the platforms.

HVMB's platform supports comprehensive fee structures, rich content, and extensive amenity options. The integration is continuously being improved to support additional fields and functionality.

If you're experiencing issues with fees, content, or amenities not displaying correctly on HVMB, please contact support. We're committed to expanding the integration capabilities and will keep you updated on progress.

 

How to contact HVMB?

Related articles