Local - Display phone numbers, addresses, and other local info

Example

Description

Display local listing information directly in Yahoo! Search. Add code to indicate to Yahoo! that a local listing exists on your page, and when we next crawl your site, we'll take care of the rest. From your markup, we’ll be able to extract structured data from your site and render it automatically in an enhanced result in search results.

Details

Types of content permitted: businesses, organizations, and points of interest.
How soon after I add my markup will I see my enhanced result appear? Assuming your markup is correct, your enhanced result will appear after Yahoo! recrawls your page; this can take between a few days and a few weeks depending on your site.

Get Started

1. Add code / markup to your site

Copy this code and replace the example text with your data to see enhanced local listing information in Yahoo! Search.

Use RDFa markup to embed local listing metadata directly in your markup. You can provide the local listing's name, address, picture, rating, and more.
Use hcard and hreview microformat markup for an alternative way to display address and review information in Yahoo! Search.
Use DataRSS XML to send your data to Yahoo! privately, using a feed. Once you have constructed your DataRSS feed, you must submit the feed to Yahoo!.

RDFa
Microformats
DataRSS XML

RDFa

Required

Click any item to toggle description on or off

xmlns:vcard(url): The VCard namespace, used for the address, telephone, photo, and URL. Format: A valid URL. The only acceptable value is "http://www.w3.org/2006/vcard/ns#".
xmlns:commerce(url): The SearchMonkey Commerce namespace, used to indicate that the organization is commercial and to provide additional optional fields, such as attire and parking options. Format: A valid URL. The only acceptable value is "http://search.yahoo.com/searchmonkey/commerce/".
vcard:VCard commerce:Business-: Indicates that the child markup applies to a local business or organization.

xmlns:rdfs(url): The RDFS namespace, used for labels and comments. Format: A valid URL. The only acceptable value is "http://www.w3.org/2000/01/rdf-schema#".
vcard:fn rdfs:label(string): The name of the local listing, such as "Steven's Cheesesteaks". Format: A string of up to 60 characters.
vcard:label rdfs:label(string): A simple, free-form postal address. A local listing should have an address — either a simple string or a more structured one (using vcard:street-address and the like). If you provide both a free-form and a structured address, the structured address takes precedence. Format: A string of up to 60 characters. To create a more structured address, use other VCard terms such as vcard:street-address and vcard:postal-code.
vcard:tel(string): A telephone number, preferably in an international format. Format: A string of up to 20 characters.

Example 1

<div typeof="vcard:VCard commerce:Business"
    xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
    xmlns:vcard="http://www.w3.org/2006/vcard/ns#"
    xmlns:commerce="http://search.yahoo.com/searchmonkey/commerce/">

     <span property="rdfs:label vcard:fn">Parcel 104</span>

     <div rel="vcard:adr">
       <div typeof="vcard:Address">
         <span property="rdfs:label">2700 Mission College Blvd, Santa Clara, CA 95054</span>
       </div>
     </div>

     <span property="vcard:tel">+1 408 970-6104</span>
 </div>

NOTE: Your local listing code might vary

Optional

Click any item to toggle description on or off

xmlns:review(url): The RDF Review namespace. This namespace is only required if you are providing aggregate review information. Format: A valid URL to the RDF Review namespace. The only acceptable value is "http://purl.org/stuff/rev#".
xmlns:xsd(url): The XML Schema namespace. This namespace is only required if you are providing explicit data types for values, such as xsd:float or xsd:integer. Format: A valid URL to the XML Schema namespace. The only acceptable value is "http://www.w3.org/2001/XMLSchema#".
rdfs:comment(string): When nested inside a vcard:VCard and a commerce:Business: a description of the local listing. Format: A string of up to 200 characters.
vcard:street-address(string): The street address of a postal address, such as "2700 Mission College Blvd". Format: A string of up to 60 characters.
vcard:locality(string): The locality (e.g., city) of a postal address. Format: A string of up to 20 characters.
vcard:region(string): The region (e.g., state or province) of a postal address. Format: A string of up to 20 characters.
vcard:postal-code(string): The postal code (e.g., U.S. ZIP code) of a postal address. Format: A string of up to 20 characters.
vcard:country-name(string): The country of a postal address. Format: A string of up to 20 characters.
vcard:latitude(float): The latitude of a geographic location. If the wrapped content is not a float, you can provide an explicit float value using the content attribute. Format: A float.
vcard:longitude(float): The longitude of a geographic location. If the wrapped content is not a float, you can provide an explicit float value using the content attribute. Format: A float.
vcard:photo(gif, jpg, png): An image that represents the local listing. Typically this is an exterior photo of the building. Alternatively, you may use vcard:logo to display the organization's logo. CAUTION: irrelevant or commercial-looking images have a strong negative impact on click-through rates. Format: A URL to a GIF, PNG, or JPG image. The image must be hosted on the same domain as the search result. The image should be 85 x 65 pixels large.
vcard:url(url): A URL associated with the local listing. Typically this is a link to the homepage of the organization. Format: A URL pointing to the local listing's homepage.
review:rating(float): The aggregate numeric value of the review. By default, this ranges between 0 and 5. Yahoo! displays reviews in stars, rounding to the nearest half star. This value must represent an aggregate review. If you provide multiple review:ratings, Yahoo! will not display the review. Format: A float bounded by review:minRating and review:maxRating.
review:minRating(integer): The minimum possible value of the review. By default, the minimum rating is 0. If you supply an explicit minimum, Yahoo! displays your rating as a numeric value rather than a star rating. Format: An integer less than review:maxRating.
review:maxRating(integer): The maximum possible value of the review. By default, the maximum rating is 5. If you supply an explicit maximum, Yahoo! displays your rating as a numeric value rather than a star rating. Format: An integer greater than review:minRating.
review:totalRatings(integer): The total number of user reviews represented by this aggregate rating. Format: An integer.
commerce:hoursOfOperation(string): A free-form description of hours of operation. Format: A string of up to 60 characters.
commerce:priceRange(float): A numeric representation for the relative price of a restaurant, hotel, shopping center, etc. By default, this ranges between 0 and 5. To reset, use commerce:priceRangeHighest and commerce:priceRangeLowest to define a new range. Format: A float bounded by commerce:priceRangeLowest and commerce:priceRangeHighest.
commerce:parkingOptions(string): A free-form list of available parking options.
commerce:attire(string): A description of required attire, such as "Casual" or "Formal".
commerce:businessCategory(string): A list of the general categories the business belongs to, such as "retail" or "winery".
commerce:cuisine(string): A free-form list of cuisines available, such as "Italian".

Example 2

<div typeof="vcard:VCard commerce:Business"
    xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
    xmlns:vcard="http://www.w3.org/2006/vcard/ns#"
    xmlns:commerce="http://search.yahoo.com/searchmonkey/commerce/"
    xmlns:review="http://purl.org/stuff/rev#"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema#">

     <span property="rdfs:label vcard:fn">Parcel 104</span>

     <span property="rdfs:comment">
         A collaborative venture of renowned chefs, Bradley Ogden and 
         Robert Sapirman. The American-themed menu celebrates seasonal 
         delights and showcases the finest efforts of local growers, 
         ranches and dairies.
     </span>

     <div rel="vcard:adr">
         <div typeof="vcard:Address">
             <!-- If address is not available in parsed form, use rdfs:label as seen in Example 1 -->
             <span property="vcard:street-address">2700 Mission College Blvd</span>
             <span property="vcard:locality">Santa Clara</span>
             <span property="vcard:region">CA</span>
             <span property="vcard:postal-code">95054</span>
             <span property="vcard:country-name">United States</span>
         </div>
     </div>

     <span property="vcard:tel">1 408 970-6104</span>

     <div rel="vcard:geo">
         <span property="vcard:latitude" datatype="xsd:float">37.392326</span>
         <span property="vcard:longitude" datatype="xsd:float">-121.974426</span>
     </div>


     <span rel="vcard:photo">
         <img src="http://example.com/restaurant.jpg"/>
     </span>

     <a rel="vcard:url" href="http://www.parcel104.com">Parcel 104</a>

     <!-- Review -->
     <div rel="review:hasReview">
         <div typeof="review:Review">
             Rated <span property="review:rating" datatype="xsd:float">3.5</span> on a scale of
             <span property="review:minRating" datatype="xsd:integer">1</span> to
             <span property="review:maxRating" datatype="xsd:integer">5</span>
             Rated <span property="review:totalRatings" datatype="xsd:integer">14</span> times.
         </div>
     </div>

     <span property="commerce:hoursOfOperation">Breakfast daily, Lunch Mon.-Fri., Dinner Mon.-Sat.</span>
     <span property="commerce:priceRange">3</span>
     <span property="commerce:parkingOptions">Valet parking &amp; parking lot</span>
     <span property="commerce:attire">Business casual</span>
     <span property="commerce:businessCategory">Restaurants, American Restaurants</span>
     <span property="commerce:cuisine">American</span>
 </div>

This metadata will be available in SearchMonkey and Yahoo! Search BOSS for further use. For more information, refer to the RDFa specification or the RDFa wiki.

NOTE: To validate your markup with RDFa attributes, use this W3C DOCTYPE:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+RDFa 1.0//EN" "http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd">

Microformats

Required

Click any item to toggle description on or off

item vcard(string): Indicates that the markup below refers to an address card.
fn org summary(string): The name of the local listing, such as "Steven's Cheesesteaks". Format: A string of up to 60 characters.

tel(string): A telephone number, preferably in an international format. Format: A string of up to 20 characters.
street-address(string): The street address of a postal address, such as "2700 Mission College Blvd". Format: A string of up to 60 characters.
locality(string): The locality (e.g., city) of a postal address. Format: A string of up to 20 characters.
region(string): The region (e.g., state or province) of a postal address. Format: A string of up to 20 characters.
postal-code(string): The postal code (e.g., U.S. ZIP code) of a postal address. Format: A string of up to 20 characters.

Example 1

<div class="vcard">
   <div class="fn org summary">Parcel 104</div>
   <span class="adr">
       <span class="street-address">2700 Mission College Blvd</span>,
       <span class="locality">Santa Clara</span>,
       <span class="region">CA</span>
       <span class="postal-code">95054</span>,
   </span>
   <span class="tel">+1 408 970-6104</span>;
</div>

This is the minimum markup you need to display local listing information on your page when that page turns up in search results.

Optional

Click any item to toggle description on or off

country-name(string): The country of a postal address. Format: A string of up to 20 characters.
latitude(float): The latitude of a geographic location. If the wrapped content is not a float, you can provide an explicit float value using the title attribute. Format: A float.
longitude(float): The longitude of a geographic location. If the wrapped content is not a float, you can provide an explicit float value using the title attribute. Format: A float.
description(string): A description of the local listing. Format: A string of up to 200 characters.
photo(gif, jpg,png): An image that represents the local listing. Typically this is an exterior photo of the building. Alternatively, you may use the class "logo" to display the organization's logo. CAUTION: irrelevant or commercial-looking images have a strong negative impact on click-through rates. Format: A URL to a GIF, PNG, or JPG image. The preview thumbnail must be hosted on the same domain as the search result. The image should be 85 x 65 pixels large.
url(url): A URL associated with the local listing. Typically this is a link to the homepage of the organization. Format: A URL pointing to the local listing's homepage.
rating(float): The aggregate numeric value of the review. By default, this ranges between 0 and 5. Yahoo! displays reviews in stars, rounding to the nearest half star. This value must represent an aggregate review. If you provide multiple ratings, Yahoo! will not display the review. Format: A float bounded by worst and best.
worst(integer): The minimum possible value of the review. By default, the minimum rating is 0. If you supply an explicit minimum, Yahoo! displays your rating as a numeric value rather than a star rating. Format: An integer less than best
best(integer): The maximum possible value of the review. By default, the maximum rating is 5. If you supply an explicit maximum, Yahoo! displays your rating as a numeric value rather than a star rating. Format: An integer greater than worst.
num(integer): The total number of user reviews represented by this aggregate rating. Format: An integer.

Example 2

<div class="hreview">
  <div class="item vcard">
      <div class="fn org summary">Parcel 104</div>
      <span class="adr">
          <span class="street-address">2700 Mission College Blvd</span>,
          <span class="locality">Santa Clara</span>,
          <span class="region">CA</span>
          <span class="postal-code">95054</span>,
      </span>
      <img class="photo" alt="Parcel 104 exterior" src="http://www.parcel104.com/wp-content/uploads/2009/03/photo175.jpg"/>
      <span class="tel">+1 408 970-6104</span>;
      <a class="url" href="http://www.parcel104.com">parcel104.com</a>

    <div class="geo">
      <abbr class="latitude" title="37.408183">51.514828</abbr>
      <abbr class="longitude" title="-122.13855">-0.122604</abbr>
    </div>
  </div>
  <div class="hreview haggregatereview">
      Rated <span class="rating">4.5</span> out of <span class="best">5</span> stars based on <span class="num"> 29</span>ratings.        
  </div>
  <div class="description"><p>
      Parcel 104 is a collaborative venture of renowned chefs,  Bradley Ogden and Robert Sapirman. The American-themed menu celebrates seasonal delights and showcases the finest efforts of local growers, ranches and dairies.
  </p></div>
</div>

This is the minimum markup you need to display local listing information on your page when that page turns up in search results.

DataRSS XML

Required

Click any item to toggle description on or off

vcard:VCard commerce:Business-: Indicates that the child markup applies to a local business or organization.

vcard:fn rdfs:label(string): The name of the local listing, such as "Steven's Cheesesteaks". Format: A string of up to 60 characters.
vcard:label rdfs:label(string): A simple, free-form postal address. A local listing should have an address — either a simple string or a more structured one (using vcard:street-address and the like). If you provide both a free-form and a structured address, the structured address takes precedence. Format: A string of up to 60 characters. To create a more structured address, use other VCard terms such as vcard:street-address and vcard:postal-code.
vcard:tel(string): A telephone number, preferably in an international format. Format: A string of up to 20 characters.

Example 1

<y:adjunct version="1.0" name="YOURID" xmlns:y="http://search.yahoo.com/datarss/">
  <y:item rel="dc:subject">
      <y:type typeof="vcard:VCard commerce:Business">
          <y:meta property="rdfs:label vcard:fn">Parcel 104</y:meta>
          <y:meta property="rdfs:comment"> A collaborative venture of renowned chefs, Bradley
              Ogden and Robert Sapirman. The American-themed menu celebrates seasonal delights and
              showcases the finest efforts of local growers, ranches and dairies. </y:meta>
          <y:meta property="commerce:hoursOfOperation"> Breakfast daily, Lunch Mon.-Fri., Dinner
              Mon.-Sat. </y:meta>

          <y:meta property="commerce:priceRange">3</y:meta>
          <y:meta property="commerce:priceRangeHighest">5</y:meta>
          <y:meta property="commerce:paymentOptions">Credit Cards</y:meta>
          <y:meta property="commerce:parkingOptions">Valet parking & parking lot</y:meta>
          <y:meta property="commerce:attire">Business casual</y:meta>
          <y:meta property="commerce:businessCategory">Restaurants, American Restaurants</y:meta>
          <y:meta property="commerce:cuisine">American</y:meta>

          <y:item rel="vcard:adr">
              <y:type typeof="vcard:Address">
              <!-- If address is not available in parsed form, use rdfs:label and supply the address as a single string -->

                  <y:meta property="vcard:street-address">2700 Mission College Blvd</y:meta>
                  <y:meta property="vcard:locality">Santa Clara</y:meta>
                  <y:meta property="vcard:region">CA</y:meta>
                  <y:meta property="vcard:postal-code" datatype="xsd:integer">95054</y:meta>
                  <y:meta property="vcard:country-name">United States</y:meta>
              </y:type>
          </y:item>

          <y:item rel="vcard:geo">
              <y:meta property="vcard:latitude" datatype="xsd:float">...</y:meta>
              <y:meta property="vcard:longitude" datatype="xsd:float">...</y:meta>
          </y:item>

          <y:item rel="vcard:url" resource="http://www.parcel104.com"/>

          <y:meta property="vcard:tel">+1 408 970-6104</y:meta>

          <y:item rel="review:hasReview">
              <y:type typeof="review:Review">
                  <y:meta property="review:rating" datatype="xsd:integer">5</y:meta>
                  <y:meta property="review:minRating" datatype="xsd:integer">1</y:meta>
                  <y:meta property="review:maxRating" datatype="xsd:integer">5</y:meta>
                  <y:meta property="review:totalRatings" datatype="xsd:integer">1</y:meta>
                  <y:meta property="review:positiveVotes" datatype="xsd:integer">12</y:meta>
                  <y:meta property="review:totalVotes" datatype="xsd:integer">13</y:meta>
              </y:type>
          </y:item>
      </y:type>
  </y:item>
</y:adjunct>

This markup would be included in a DataRSS feed.

Optional

Click any item to toggle description on or off

rdfs:comment(string): When nested inside a vcard:VCard and a commerce:Business: a description of the local listing. Format: A string of up to 200 characters.
vcard:street-address(string): The street address of a postal address, such as "2700 Mission College Blvd". Format: A string of up to 60 characters.
vcard:locality(string): The locality (e.g., city) of a postal address. Format: A string of up to 20 characters.
vcard:region(string): The region (e.g., state or province) of a postal address. Format: A string of up to 20 characters.
vcard:postal-code(string): The postal code (e.g., U.S. ZIP code) of a postal address. Format: A string of up to 20 characters.
vcard:country-name(string): The country of a postal address. Format: A string of up to 20 characters.
vcard:latitude(float): The latitude of a geographic location. If the wrapped content is not a float, you can provide an explicit float value using the content attribute. Format: A float.
vcard:longitude(float): The longitude of a geographic location. If the wrapped content is not a float, you can provide an explicit float value using the content attribute. Format: A float.
vcard:photo(gif, jpg, png): An image that represents the local listing. Typically this is an exterior photo of the building. Alternatively, you may use vcard:logo to display the organization's logo. CAUTION: irrelevant or commercial-looking images have a strong negative impact on click-through rates. Format: A URL to a GIF, PNG, or JPG image. The image must be hosted on the same domain as the search result. The image should be 85 x 65 pixels large.
vcard:url(url): A URL associated with the local listing. Typically this is a link to the homepage of the organization. Format: A URL pointing to the local listing's homepage.
review:rating(float): The aggregate numeric value of the review. By default, this ranges between 0 and 5. Yahoo! displays reviews in stars, rounding to the nearest half star. This value must represent an aggregate review. If you provide multiple review:ratings, Yahoo! will not display the review. Format: A float bounded by review:minRating and review:maxRating.
review:minRating(integer): The minimum possible value of the review. By default, the minimum rating is 0. If you supply an explicit minimum, Yahoo! displays your rating as a numeric value rather than a star rating. Format: An integer less than review:maxRating.
review:maxRating(integer): The maximum possible value of the review. By default, the maximum rating is 5. If you supply an explicit maximum, Yahoo! displays your rating as a numeric value rather than a star rating. Format: An integer greater than review:minRating.
review:totalRatings(integer): The total number of user reviews represented by this aggregate rating. Format: An integer.
commerce:hoursOfOperation(string): A free-form description of hours of operation. Format: A string of up to 60 characters.
commerce:priceRange(float): A numeric representation for the relative price of a restaurant, hotel, shopping center, etc. By default, this ranges between 0 and 5. To reset, use commerce:priceRangeHighest and commerce:priceRangeLowest to define a new range. Format: A float bounded by commerce:priceRangeLowest and commerce:priceRangeHighest.
commerce:parkingOptions(string): A free-form list of available parking options.
commerce:attire(string): A description of required attire, such as "Casual" or "Formal".
commerce:businessCategory(string): A list of the general categories the business belongs to, such as "retail" or "winery".
commerce:cuisine(string): A free-form list of cuisines available, such as "Italian".

2. Validate your markup

Test your markup to make sure your enhanced result will appear.

3. Wait until we recrawl your site for your enhanced result to appear on the search results page

This can take up to a few weeks depending on your site.

Help us continue to improve the Yahoo! Developer Network: Send Your Suggestions

Local - Display phone numbers, addresses, and other local info

Example

Description

Details

Get Started

1. Add code / markup to your site

RDFa

Required

Recommended

Example 1

Optional

Example 2

Microformats

Required

Recommended

Example 1

Optional

Example 2

DataRSS XML

Required

Recommended

Example 1

Optional

2. Validate your markup

3. Wait until we recrawl your site for your enhanced result to appear on the search results page