Note

Customer feedback, ideas, conversations, and insights collected across your product discovery process. Notes are the primary way feedback enters Productboard.

What is a Note?

A Note is a piece of customer feedback, an idea, a conversation, or an insight captured in Productboard. When you collect feedback from a stakeholder — whether through a support tool, sales call, or survey — that feedback is packaged into a note. Notes are the primary entry point for voice-of-the-customer data.

Notes can be linked to features to quantify demand and inform prioritization. When you link a note to a feature, that link is called an insight. Insights are how Productboard connects raw customer feedback to specific feature ideas, letting you see exactly how much demand exists for each feature. Notes can also be linked to companies and users to track which customers care about what.

Note types

Productboard supports three note types:

TypeAPI valueDescription
Text NotetextNoteStandard freeform note for capturing feedback, ideas, or internal observations. The most common type.
Conversation NoteconversationNoteMulti-part threaded content representing a dialogue — for example, a support ticket conversation between a user and an agent. Each part has its own timestamp and author.
Opportunity NoteopportunityNoteStructured feedback linked to sales or market opportunities, with key-value fields for amounts, dates, and descriptions. Typically imported from CRMs like Salesforce. Currently read-only via API.

When to use it

  • Feedback ingestion — Push customer feedback from support tools (Zendesk, Intercom), CRMs (Salesforce, HubSpot), or custom channels into Productboard.
  • Feedback export — Pull notes for analysis in BI tools or data warehouses.
  • Automated tagging — Read notes and update their tags or status programmatically based on content analysis.
  • Customer intelligence — Query notes linked to a specific company or user to understand their needs before a meeting.
  • Insight creation — Link notes to features to create insights that quantify demand.

Key fields

FieldDescription
nameTitle of the note
contentThe note body (rich text for text notes, structured parts for conversations)
tagsLabels for categorizing notes
ownerThe member who owns this note
creatorThe member who created this note
processedWhether the note has been reviewed and processed
archivedWhether the note has been archived
sourceOrigin metadata — external ID, system name, and source URL

Field availability depends on your workspace configuration. Use the Note Configuration endpoint to discover available fields.

Relationships

Notes support these relationship types:

RelationshipDescription
customerThe company or user this feedback came from (by ID or email)
hierarchyItemFeatures, components, or other product hierarchy entities this note is linked to — each link creates an "insight"
linkExternal URLs associated with this note

Manage relationships via PATCH /notes/{id}/relationships/{relationshipType}.

Related objects

  • Feature — features that this note provides evidence for
  • Company — the company this feedback is associated with
  • User — the individual user who provided the feedback
  • Member — the workspace member who owns or created the note

Learn more