{"id":365508,"date":"2025-10-26T11:46:04","date_gmt":"2025-10-26T05:46:04","guid":{"rendered":"https:\/\/directorist.com\/?post_type=docs&p=365508"},"modified":"2025-10-26T11:46:08","modified_gmt":"2025-10-26T05:46:08","password":"","slug":"compare-listings","status":"publish","type":"docs","link":"https:\/\/directorist.com\/docs\/compare-listings\/","title":{"rendered":"Compare Listings"},"content":{"rendered":"\n

Overview <\/h2>\n\n\n\n

The Compare Listings<\/strong> extension allows your users to select multiple listings and view them side by side in a comparison table \u2014 helping them decide more easily without bouncing between pages. <\/p>\n\n\n\n

Why Use the Compare Listings Extension?<\/strong> <\/h2>\n\n\n\n

Switching between multiple detail pages can be cumbersome and time-consuming. With this extension:<\/p>\n\n\n\n

    \n
  • Users can compare 2\u20135 listings<\/strong> in a single view
    <\/li>\n\n\n\n
  • Essential listing attributes (e.g. price, rating, category) appear side by side
    <\/li>\n\n\n\n
  • You can include custom fields<\/strong> in comparisons, giving flexibility for your directory\u2019s unique attributes
    <\/li>\n\n\n\n
  • The \u201cCompare\u201d button can appear in many strategic locations
    <\/li>\n\n\n\n
  • It\u2019s fully responsive and supports translations
    <\/li>\n<\/ul>\n\n\n\n

    For example, in a real estate directory, someone can pick several apartments, compare their features (square footage, amenities, price, etc.), and choose the best option \u2014 all in one glance. <\/p>\n\n\n\n

    Key Features <\/h2>\n\n\n\n
      \n
    • Compare up to 5 listings<\/strong> in one table
      <\/li>\n\n\n\n
    • Compare built-in attributes like price, rating, category
      <\/li>\n\n\n\n
    • Support for custom fields<\/strong> (so you choose which attributes users compare)
      <\/li>\n\n\n\n
    • Flexible display of \u201cCompare\u201d buttons on:
      \n
        \n
      • All Listings pages
        <\/li>\n\n\n\n
      • Single Listing pages
        <\/li>\n\n\n\n
      • Related Listings
        <\/li>\n\n\n\n
      • User dashboard \/ author profile
        <\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • Option to exclude<\/strong> the compare button on specific pages
        <\/li>\n\n\n\n
      • Set a limit<\/strong> (2\u20135) on how many listings a user can compare
        <\/li>\n\n\n\n
      • Fully responsive<\/strong> layout
        <\/li>\n\n\n\n
      • Translatable (compatible with localization) <\/li>\n<\/ul>\n\n\n\n

        How It Works (User Flow)<\/strong> <\/h2>\n\n\n\n
          \n
        1. A user clicks \u201cAdd to Compare\u201d (or a similar label) on any listing.
          <\/li>\n\n\n\n
        2. That listing is added to a temporary compare list (up to the defined limit).
          <\/li>\n\n\n\n
        3. Users can view the comparison page, where each selected listing is arranged side by side, with comparison rows for each attribute.
          <\/li>\n\n\n\n
        4. Users may remove listings, or proceed to inspect more closely or act (contact, purchase, etc.).
          <\/li>\n<\/ol>\n\n\n\n

          Because custom fields are supported, you can include exactly those attributes you want your users to compare \u2014 e.g. \u201cBedrooms,\u201d \u201cWarranty,\u201d \u201cAmenities,\u201d etc. <\/p>\n\n\n\n

          Setup & Configuration<\/strong> <\/h2>\n\n\n\n

          You can manage Compare Listings settings under Directory Listings \u2192 Settings \u2192 Extensions \u2192 Compare Listings<\/strong>.<\/p>\n\n\n\n

          Typical configurable options include: <\/p>\n\n\n\n

          Setting<\/strong><\/td>Purpose<\/strong><\/td><\/tr>
          Title<\/strong><\/td>The heading for the comparison page (e.g. \u201cCompare Listings\u201d)<\/td><\/tr>
          Limit<\/strong><\/td>Maximum number of listings a user may compare (between 2 and 5)<\/td><\/tr>
          Button Locations<\/strong><\/td>Choose where \u201cCompare\u201d buttons appear (All Listings, Single Listing, Author Profile, etc.)<\/td><\/tr>
          Exclude Pages<\/strong><\/td>Provide a list of pages where the compare button should not<\/em> appear<\/td><\/tr>
          Save Changes<\/strong><\/td>Always save after adjusting settings<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

          You\u2019ll also need to add the Compare button into your listing layouts:

          All Listings page<\/strong>: Under Directory Builder \u2192 All Listing Layout<\/em>, insert the Compare Listing Button at your desired position. <\/p>\n\n\n\n

          Single Listing page<\/strong>: Under Directory Builder \u2192 Single Page Layout \u2192 Listing Header<\/em>, insert the compare button in the appropriate spot. <\/p>\n\n\n\n

          Note: Once users click \u201cCompare,\u201d a sidebar or section will show their selected listings. They can remove items with a trash icon or click \u201cCompare\u201d to view the full comparison.
          (Images illustrating these steps help guide users visually.)<\/em> <\/p>\n\n\n\n

          Example Workflow with Images<\/strong> <\/h2>\n\n\n\n
            \n
          1. Adding listings<\/strong> \u2014 Users click the compare button on listings they like.<\/li>\n<\/ol>\n\n\n\n
              \n
            1. Sidebar list<\/strong> \u2014 Selected listings appear in a sidebar or floating area.<\/li>\n<\/ol>\n\n\n\n
                \n
              1. Remove option<\/strong> \u2014 A trash icon lets users remove any listing from the list.<\/li>\n<\/ol>\n\n\n\n
                  \n
                1. Compare view<\/strong> \u2014 On clicking \u201cCompare,\u201d the listings open side by side in a dedicated comparison table.<\/li>\n<\/ol>\n\n\n\n

                  Considerations & Best Practices<\/strong> <\/h2>\n\n\n\n
                    \n
                  • Use clear labels<\/strong> (e.g. \u201cAdd to Compare,\u201d \u201cRemove,\u201d \u201cCompare Now\u201d) to avoid confusion
                    <\/li>\n\n\n\n
                  • Avoid including too many fields \u2014 choose only the most meaningful attributes
                    <\/li>\n\n\n\n
                  • Keep the comparison limit<\/strong> manageable (5 is a good standard)
                    <\/li>\n\n\n\n
                  • Place the compare button consistently<\/strong> across views (grid, list, single)
                    <\/li>\n\n\n\n
                  • Always check mobile \/ responsive views<\/strong> to make sure the table remains legible
                    <\/li>\n\n\n\n
                  • Test excluding pages to avoid clutter in places where compare doesn\u2019t make sense<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"

                    Overview The Compare Listings extension allows your users to select multiple listings and view them side by side in a comparison table \u2014 helping them decide more easily without bouncing between pages. Why Use the Compare Listings Extension? Switching between multiple detail pages can be cumbersome and time-consuming. With this extension: For example, in a […]<\/p>\n","protected":false},"author":22343,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[694],"doc_tag":[],"class_list":["post-365508","docs","type-docs","status-publish","hentry","doc_category-extensions"],"year_month":"2026-03","word_count":581,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"Fairose Farabi","author_nicename":"farabisovware","author_url":"https:\/\/directorist.com\/author\/farabisovware\/"},"doc_category_info":[{"term_name":"Extensions","term_url":"https:\/\/directorist.com\/docs-category\/extensions\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/365508","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/users\/22343"}],"replies":[{"embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/comments?post=365508"}],"version-history":[{"count":0,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/docs\/365508\/revisions"}],"wp:attachment":[{"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/media?parent=365508"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_category?post=365508"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/directorist.com\/wp-json\/wp\/v2\/doc_tag?post=365508"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}