Commerce Objects

The Essence

The Listing is HubSpot's flexible container โ€” a "blank slate" object that can represent almost anything your business needs to track that doesn't fit neatly into other native objects.

Real estate properties. Job postings. Equipment inventory. Event venues. Media assets. Resource directories. The Listing answers "what do we have available, in what state, for whom?"

It's intentionally generic, designed to be configured for your specific use case rather than constrained to one domain. Think of Listings as the "Other" category made useful โ€” structured enough to have pipelines, properties, and associations, flexible enough to represent whatever your business needs to list, discover, and manage.

"Listings aren't a specific thing โ€” they're whatever your business needs to list and track. The flexibility is the feature."


Unified View Contribution


Sarah's Story

Value-First used Listings in a creative way that benefited Sarah:

The Resource Library: Value-First maintained a Listing of implementation resources โ€” templates, guides, reference architectures, training materials. Each resource was a Listing record:

- Listing: CVP Manufacturing Implementation Checklist - Type: Implementation Resource - Category: Manufacturing - Stage: Published - Format: PDF + Notion Template - Associated To: Product (CVP Implementation)

When Sarah's implementation began, Ryan associated relevant Listings to her Company record. Sarah could see in her portal: "Resources for Your Implementation" โ€” a curated set of materials connected to her engagement.

The Partner Directory: Value-First also used Listings for their partner ecosystem โ€” integration partners, implementation specialists, complementary service providers:

- Listing: ERP Integration Specialist - Midwest Region - Type: Partner - Category: Technical Implementation - Stage: Active - Capabilities: NetSuite, SAP Business One, Dynamics - Region: Midwest US

When Sarah needed ERP integration support, Value-First could quickly identify and introduce relevant partners. The Listing object made the partner network searchable and manageable.

The Event Venue Tracking: For their annual Summit, Value-First tracked potential venues as Listings:

- Listing: Austin Convention Center - Main Hall - Type: Event Venue - Category: Conference - Stage: Under Evaluation - Capacity: 500 - Rate: $15,000/day - Available Dates: March 2025

Venues moved through a pipeline: Identified โ†’ Under Evaluation โ†’ Proposal Received โ†’ Selected โ†’ Contracted. The Listing object gave structure to what would otherwise be scattered notes and spreadsheets.


What It Holds

Identity

Name, description, type, category. What is this Listing? The basic definition that distinguishes one Listing from another.

Classification

Type and category properties enable filtering and organization. Configure these for your specific use case โ€” resources, partners, assets, or anything else.

Status/Pipeline

Where is this Listing in its lifecycle? Available, Reserved, Active, Archived โ€” stages depend on your use case. Pipeline thinking applied to any trackable item.

Ownership

Who manages this Listing? Team member accountability for resources, assets, and processes.

Attributes

Whatever properties make sense for your use case โ€” location, capacity, price, specifications, availability dates. Completely customizable.

Associations

Which Contacts, Companies, or other records connect to this Listing? Relationships give Listings context.

What It Connects To

Primary Associations

To Contacts

Who owns, manages, or is associated with this Listing? Resource owners, users, primary contacts.

To Companies

What organization context applies? Training clients, listed organizations, asset owners.

To Products

What Products does this Listing support? Resources connected to offerings.

To Other Objects

Deals, Services โ€” whatever makes sense for your use case.

Resource Listing Labels

Resource Owner
1

Person who maintains this resource

Has Access
โˆž

Contacts with access to this resource

Assigned To
โˆž

Company this resource is assigned to

Partner/Asset Labels

Primary Contact
1

Main point of contact

Listed Organization
1

Company in the directory

Assigned User
1

Person currently using asset

Asset Owner
1

Company that owns asset

Labels Depend on Use Case

Because Listings are flexible, association labels should match your purpose. Resource Listings might use "Owner" and "Has Access." Partner Listings might use "Primary Contact" and "Listed Organization." Asset Listings might use "Assigned User" and "Asset Owner." Configure labels that make sense for what you're tracking.


Common Patterns

The Resource Library Pattern

Discoverable content/materials: Resource created โ†’ Listing record created โ†’ Type: Resource โ†’ Category: [Training/Template/Guide/etc.] โ†’ Stage: Draft โ†’ Review โ†’ Published โ†’ Archived โ†’ Associated to: Products it supports, Contacts who authored. Searchable library with lifecycle tracking.

The Directory Pattern

Partners, vendors, providers: Entity identified โ†’ Listing created โ†’ Type: Partner/Vendor/Provider โ†’ Category: [Capability area] โ†’ Stage: Prospect โ†’ Active โ†’ Preferred โ†’ Inactive โ†’ Associated to: Contacts at the organization, Companies. Managed directory with status tracking.

The Asset Inventory Pattern

Equipment, resources, assets: Asset acquired โ†’ Listing created โ†’ Type: Equipment/Asset โ†’ Stage: Available โ†’ Reserved โ†’ In Use โ†’ Maintenance โ†’ Retired โ†’ Associated to: Current user (Contact), Location (Company). Asset tracking without specialized inventory system.

The Availability Pattern

Bookable resources (venues, rooms, equipment): Resource exists โ†’ Listing created โ†’ Stage: Available โ†’ Reserved โ†’ Confirmed โ†’ In Use โ†’ Available โ†’ Properties: Availability dates, capacity, rate, requirements โ†’ Workflow: Reservation requests โ†’ approval โ†’ confirmation. Simple resource booking through pipeline stages.

The Catalog Pattern

Items for discovery (not Products): Item to be listed โ†’ Listing created โ†’ Type: [Item category] โ†’ Stage: Draft โ†’ Listed โ†’ Featured โ†’ Archived โ†’ Portal integration: Discoverable via search/filter. Public or customer-facing catalog capability.

Value-First vs. Industrial-Age

โœ— Traditional Thinking โœ“ Value-First Thinking
Spreadsheets for everything else Structured objects for trackable items
Data scattered across tools Resources connected to CRM context
No pipeline for non-sales items Pipeline thinking for any staged process
Items disconnected from relationships Items associated to Contacts/Companies
Custom objects for every need Flexible container adapted to purpose

Why This Shift Matters

Traditional CRM thinking reserves structured tracking for sales-centric objects โ€” Deals, Tickets, Contacts. Everything else ends up in spreadsheets, notes, or external tools. This creates data silos: your partner directory is disconnected from your CRM, your resource library isn't associated to customers, your asset inventory has no relationship context.

Listings bridge this gap. By bringing "everything else" into the CRM as structured records, you can associate resources to the relationships they serve, track lifecycle stages for any type of item, enable team ownership and accountability, report on resource utilization, and create portal experiences for discoverable content.


In Practice

Implementation details and configuration

What You'll See in HubSpot

Listings appear in CRM โ†’ Listings (once activated). Each Listing has:

  • Left sidebar: Listing properties, status, owner
  • Middle column: Activity timeline, notes, tasks
  • Right sidebar: Associations to Contacts, Companies, other objects

Activating Listings: Navigate to Settings โ†’ Data Management โ†’ Objects โ†’ Object Library. Toggle on Listings, configure pipelines for your use case, and create properties relevant to your Listing types.

Key Properties

Properties depend on use case. Below are examples for different Listing types:

Key Properties

Native HubSpot Properties

Property Type Purpose
hs_listing_name Native Text Listing title
hs_listing_description Native Text What this Listing represents
hs_listing_status Native Enumeration Active, Inactive, Archived
hs_pipeline Native Pipeline Which workflow
hs_pipeline_stage Native Stage Current stage
hubspot_owner_id Native User Who manages this

Value-First Custom Properties

Property Type Purpose
resource_type Enumeration Template, Guide, Video, Document
resource_category Enumeration Training, Implementation, Reference
resource_url URL Where to access
partner_type Enumeration Implementation, Integration, Consulting
capabilities Multi-checkbox What they do
regions_served Multi-checkbox Geographic coverage
asset_type Enumeration Equipment type
asset_id Text Inventory number
current_location Text Where it is

Example: Resource Library Pipeline

1

Draft

Resource development in progress

Entry Criteria

Content being created

Exit Criteria

Ready for review

Portal Experience

If using Listings in customer portal:

Resource Library

Browse by category/type, search by keyword, filter by applicable Product, access resources associated to their Company.

Partner Directory

Browse partners by capability, filter by region/specialty, view partner profiles, request introductions.

"The portal experience depends entirely on your Listing use case โ€” Listings are flexible enough to power various discovery experiences."


See It In Action

Experience in the Value Path Simulator

โ†’ Resource Library: See implementation resources as Listings associated to Products
โ†’ Partner Directory: Browse partner Listings by capability
โ†’ Lifecycle Tracking: Watch Listings move through pipeline stages
โ†’ Association Value: Notice how Listing association to Sarah's Company enables personalized resource access

Key Moment: Listings aren't a specific thing โ€” they're whatever your business needs to list and track. The flexibility is the feature.

Experience Listing in the Value Path Simulator


Explore Further