Products

The product catalog stores your inventory inside Pigeon Perch, whether you sell physical goods, list real estate, or offer services. Once your products are synced, you can embed them directly in email templates for targeted, personalized campaigns.

Why Connect Your Product Catalog

Emails that feature relevant products consistently outperform generic newsletters. By connecting your catalog to Pigeon Perch, you can send product announcements with accurate prices and images, use the product recommender to personalize each recipient's experience, and keep your email content in sync with your store automatically.

Getting Products Into Pigeon Perch

Manual Entry

Add products one at a time from the Products page. Enter a name, description, price, image URL, and category. Best for small catalogs or one-off additions.

CSV or API Import

Bulk import up to 5,000 products at a time via the POST /api/v1/listings/import endpoint. Include an optional external ID for deduplication on re-import.

RSS / Atom Feed Sync

Paste your product feed URL in the Sync Settings panel. Pigeon Perch parses the feed, creates or updates products, and archives items no longer in the feed. This is the recommended approach for keeping your catalog current with minimal effort.

Shopify Integration

Point your Shopify product webhooks at the POST /api/v1/listings/sync/shopify endpoint with your API key. Products sync in real time whenever they change in your Shopify store.

CMS Webhook

Any CMS that supports outbound webhooks can push product updates. Copy the webhook URL from the Sync Settings panel, add your API key header, and send updates as they happen.

MLS (Real Estate)

Real estate listings can be imported via the MLS sync endpoint, mapping standard fields like address, list price, photos, property type, and square footage.

Product Locations

Products can optionally include location data: latitude, longitude, city, state, country, and postal code. This is useful for businesses with location-specific inventory, such as real estate listings, multi-location retail, or event venues.

When creating or updating a product, include the location fields in the API request or set them in the product editor. Products with locations can be filtered in Product Lists using the Location Radius filter, which finds all products within a given distance of a point. For example, a real estate company can create a dynamic product list of all active listings within 25 miles of downtown Austin.

Using Products in Email Templates

Add a Product block to any template. Choose manual selection to feature a specific product, or recommended to let Pigeon Perch pick products personalized for each recipient at send time (Growth and Scale plans).

See the Templates documentation for details on configuring product blocks.

Keeping Products Current

Automated sync is the best approach. Whether you use a feed, Shopify webhooks, or a CMS webhook, your catalog stays in sync without manual intervention. Removed products are archived (not deleted) so historical email references remain intact.