{
    "componentChunkName": "component---src-templates-article-page-template-js",
    "path": "/concepts/listing-extended-data/",
    "result": {"data":{"markdownRemark":{"frontmatter":{"title":"Listing extended data","slug":"listing-extended-data","updated":"2022-09-29T00:00:00.000Z","category":"concepts-extended-data","ingress":"Listing extended data allows you to use the powerful search engine in Flex, as well as customise your listing information.","skills":null},"htmlAst":{"type":"root","children":[{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Listings can have three types of extended data: public, private, and\nmetadata. This article gives an overview of using these different\nextended data types."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"viewing-and-modifying-listing-extended-data","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#viewing-and-modifying-listing-extended-data","ariaLabel":"viewing and modifying listing extended data permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Viewing and modifying listing extended data"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Public data and metadata are visible to everyone – in other words, they\nare available when querying listings through the\n"},{"type":"element","tagName":"a","properties":{"href":"https://www.sharetribe.com/api-reference/marketplace.html#listings","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"public listing endpoints"}]},{"type":"text","value":"\nin Marketplace API. Public data and metadata can be used, for instance,\nto distinguish different types of listings from each other, or to allow\nmarketplace users to filter and search for specific features on a\nlisting. Operators can use metadata to categorise listings to regular\nand premium, for instance."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"On the other hand, listing private data is available through the\n"},{"type":"element","tagName":"a","properties":{"href":"https://www.sharetribe.com/api-reference/marketplace.html#own-listings","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"ownListing endpoints"}]},{"type":"text","value":"\nin Marketplace API and\n"},{"type":"element","tagName":"a","properties":{"href":"https://www.sharetribe.com/api-reference/integration.html#listings","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"listing endpoints"}]},{"type":"text","value":"\nin Integration API. Private data can be used to allow the listing author\nto make private notes on the listing, since the information is not\nvisible for the general marketplace audience."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"The listing's author can modify the listing's public and private data\nthrough the\n"},{"type":"element","tagName":"a","properties":{"href":"https://www.sharetribe.com/api-reference/marketplace.html#own-listings","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"ownListing"}]},{"type":"text","value":"\ncreate and update endpoints. An operator can modify all listing extended\ndata, either through\n"},{"type":"element","tagName":"a","properties":{"href":"https://www.sharetribe.com/api-reference/integration.html#listings","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"Integration API"}]},{"type":"text","value":"\nor in Flex Console."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"search-and-filtering","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#search-and-filtering","ariaLabel":"search and filtering permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Search and filtering"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"How users search and filter listings is a vital part of their experience\nin your marketplace. A smooth search experience allows them to find the\nlistings they’re interested in effortlessly, and the right filters help\nthem narrow down results to a selection that best fits their needs.\nExtended data helps you build the custom search and filtering experience\nyour marketplace needs."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Listings can be searched by keyword or location using Flex’s\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/concepts/how-the-listing-search-works/"},"children":[{"type":"text","value":"powerful built-in search feature"}]},{"type":"text","value":".\nIn addition to this, you can use listing public extended data and\nmetadata to create a variety of different types of filters; for example,\na filter can be a slider with a range of values or a checkbox group. You\ncan also specify how listings are prioritized and sorted in the results.\nExtended data is not available for search or sorting by default, which\nmeans you are in control of building your own, unique search experience."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"When planning your search experience, think about the following\nquestions: Do you want the extended data in any given field to be\nsearchable? Do you want it to be a filter as well as a search parameter?\nWhat kind of filter should it be? Which extended data should be\nprioritized in search results?"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Maybe your marketplace charges a membership fee, and you want listings\nfrom sellers in your highest subscription tier to be displayed first. Or\nperhaps your marketplace is for selling preowned clothing, and you want\nyour users to be able to filter by size to find the best fit. The\npossibilities are numerous!"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"different-types-of-listings","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#different-types-of-listings","ariaLabel":"different types of listings permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Different types of listings"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"A marketplace can have several types of listings – rentals and sales,\nevents and facilities. Listing extended data is a powerful way to\ndistinguish different listing types. Read more about the possibilities\nfor\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/concepts/listings-overview/#different-types-of-listings"},"children":[{"type":"text","value":"different listing types in Flex"}]},{"type":"text","value":"."}]}],"data":{"quirksMode":false}},"headings":[{"value":"Viewing and modifying listing extended data","depth":2},{"value":"Search and filtering","depth":2},{"value":"Different types of listings","depth":2}]}},"pageContext":{"slug":"listing-extended-data","category":"concepts-extended-data"}},
    "staticQueryHashes": ["3794076007","439097193","717698143"]}