> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mylisting.club/llms.txt
> Use this file to discover all available pages before exploring further.

# Listing Snippets

> Select listings from preview cards, choose which fields to include, and copy the content so you can share listings details in emails, posts, or anywhere else.

## Per Listing Type

Turn **Listing Snippets** on only for specific **listing types.**

For each **enabled** listing type, you get granular control over what flows into the **Content Sharing Builder**, including the max number of listings someone can pick, the default layout, and which fields content can pull from.

## Page Visibility

Listing Snippets can add **Preview Card Icons** and two bottom drawers to pages that have **Preview Cards**. The **Page Visibility** setting lets you decide whether that UI appears site-wide or only on specific pages.

## Preview Card Icon

Listing Snippets adds a fully customizable icon with tooltips to the top-right corner of each listing preview card. When users click the icon, the listing is added to the content sharing builder.

## Bottom Drawers

Listing Snippets adds a polished selection flow with two bottom drawers that never fight for attention. You control everything, including the icons, copy, colors, borders, animations, and more, for each drawer, scope where the UI appears with **Page Visibility**, and send visitors into a dedicated builder to copy listing content for outreach.

### Intro Drawer

The **Intro Drawer** is the first thing visitors see: it slides up after load with your heading, instructions, and branding, so people know how to pick listings before they tap a card. When they start selecting, that drawer steps aside and the **Actions Bar** slides in with action buttons, keeping the workflow compact and obvious.

### Actions Drawer

Actions Drawer takes over the moment visitors start building a snippet: as soon as they choose one or more listings, the **Intro Drawer** steps aside and a compact bottom drawer slides up with your primary and secondary buttons, so the next step is obvious without rereading instructions.

Paired with **Page Visibility** and the **Intro Drawer**, the Actions Drawer turns into a guided, professional workflow that ends at your content sharing builder.

## Content Sharing Builder

The Content Sharing Builder is the page visitors land on after the **Actions Drawer** step: a focused workspace where users can pick a layout, choose listing fields to include, preview the result, and copy rich HTML or plain text ready for a newsletter, outreach email, or internal doc.

> [accordion] Who is this module for?
>
> * Referral and concierge teams sending curated listing lists to clients
> * Membership or B2B directories where partners share their picks
> * Site owners who want copy-paste listing content without building layouts by hand

> [accordion] What are the key benefits?
>
> * **Faster outreach:** build a snippet in minutes instead of copying fields one by one
> * **Consistent branding:** email-safe templates (Spotlight, Cards Row, Simple List) with adjustable colors
> * **Flexible control:** enable the feature per listing type, limit how many listings can be selected, and choose default fields
> * **Polished UX:** customizable icons, labels, headings, and colors on preview cards and the selection bar

> [accordion] What is the front-end user experience?
>
> 1. On pages where Listing Snippets is active (the ones you chose under **Page Visibility**), the visitor opens a page with listing preview cards for a listing type you enabled.
> 2. If you configured intro copy, an **Intro Drawer** will slide up from the bottom, displaying your heading, instructions, and body text.
> 3. On enabled types, each preview card shows a **Preview Card Icon** (top-right). The visitor taps it to select listings; chosen cards are outlined or highlighted.
> 4. After the first selection, the **Intro Drawer** hides and the **Actions Drawer** slides up with your primary and secondary action buttons (for example, Create Snippet and Clear, or your custom labels).
> 5. They tap the primary button to open the content sharing builder with the selected listings.
> 6. In the **Content Sharing Builder**, they pick a template, toggle which fields to include, preview the listing block, then copy rich HTML or plain text and paste it into a newsletter, email, or post.

> [accordion] Do you have any useful tips?
>
> 1. Enable one listing type first so you can test the full flow before rolling out to others.
> 2. Set Max Selections to match your use case. Referral emails often use 3 to 5 listings.
> 3. Limit Fields to what recipients truly need. Fewer fields mean cleaner snippets.
> 4. The **Spotlight template** works well for one or two hero listings. **Cards Row** and **Simple List** work well for longer lists.
> 5. **Primary Button Label:** Use language your audience expects, for example, “Build Email” or “Create Snippet."

> [accordion] How do we get started?
>
> 1. **MyListing Pro → Modules → Listing Snippets →** Enable
> 2. **Listing Snippets → Listing Types →** Enable the listing types you want to allow, choose the max number of selections, the default template, and the desired fields to include in the **Content Sharing Builder**
> 3. \*\*Listing Snippets → \*\*Configure the remaining settings as desired
> 4. Save Changes
> 5. Visit a page on your site where the enabled listing type preview cards appear and confirm the cards display the **Preview Card Icon**
> 6. Confirm the **Intro Drawer** shows if that's what you expected
> 7. Select one or more listings and confirm the **Action Drawer** appears
> 8. Click the **Primary Button** (default label Create Snippet) to open the **Content Sharing Builder**
> 9. Make your selections and either **Copy Rich Content** or **Copy Plain Text**
> 10. Test by pasting in the copied text into an email, document, etc.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.