The top-level entity representing a company or team that owns one or more products.
An organisation is the company at the top of the portfolioPortfolioPortfolioA grouping of products by strategic axisView reference → hierarchy: the entity that owns products, allocates capital across them, and sets the strategy the rest of the structure serves. It is the answer to "who, ultimately, is doing all this?" The interesting case is the multi-product company, where one organisation runs several products that compete for the same finite budget and attention.
The idea that a firm is the deliberate alternative to coordinating everything through the open market goes back to Ronald Coase's 1937 paper The Nature of the Firm, which argued that organisations exist because internal coordination is sometimes cheaper than transacting in the market. That framing explains why a single organisation chooses to own and manage a portfolio of products rather than spin each one out.
As firms grew into multiple product lines, the question became how to structure them. Alfred Chandler's Strategy and Structure (1962) traced the rise of the multidivisional form, where a corporate centre oversees semi-autonomous units organised around products or markets. The modern product organisation, with its split between a corporate parent and product-aligned areas, is a direct descendant of that shift.
The practical lesson is that "organisation" carries several meanings that needNeedUserA user need, pain, desire, or constraintView reference → separating. The operating company that builds and runs products is distinct from the legal entityLegal EntityLegalA legal entity (company, subsidiary)View reference → that signs contracts and files accounts, and both differ from the department or product areaProduct AreaPortfolioA grouping of products by organisational axisView reference → that does a slice of the work. A holding company might own three legal entities running five products across a dozen areas. Collapsing those layers into one node makes capital allocation and ownership impossible to model cleanly.
A 400-person company runs three products: a mature analytics tool that funds the business, a younger collaboration app growing fast, and an early experimentExperimentValidationA test designed to validate a hypothesisView reference → in AI tooling. As an organisation it allocates engineering headcount and budget across all three, and that allocation is a single contested decisionDecisionStrategyA recorded decision with context, rationale, and consequencesView reference → rather than three independent ones. Funding the AI experimentAI ExperimentAI & Machine LearningAn AI-focused experimentView reference → means the analytics tool waits a quarter for its replatforming.
The organisation is also organised internally into product areas, so the collaboration app's growth team and the analytics tool's platform team report up through the same structure. Naming the organisation as the explicit top of the hierarchy makes the trade-off legible: every product and every area traces back to one entity that decides where the money goes.
In the Unified Product Graph, an organisation anchors the portfolio region as the top of the ownership hierarchy. The Organizationinvests viaPortfoliohierarchy edge connects it to the portfolio through which it allocates capital, and organization_invests_via_portfolioOrganizationorganised intoProduct Areahierarchy connects it down to the internal units that do the work. Keeping the organisation distinct from its legal entities and its product areas means capital allocation, legal structure, and operating structure can each be modelled and queried on their own terms, instead of being flattened into a single ambiguous "company" node.organization_organised_into_product_area
Type-specific fields on BaseNode
logo_urlstringURL of the organisation's logo
billing_planstringCurrent billing / subscription plan
industrystringIndustry vertical the organisation operates in
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
2 edge types connected to this entity.
organization_invests_via_portfolioorganization_organised_into_product_areaOrganization is the root of the portfolio hierarchy. It owns portfolios on the strategic axis and product areas on the organisational axis.
In a portfolio document, Organization entities can participate in cross-product edges, the typed relationships that link entities across different products. These edges are declared in UPGPortfolioDocument.cross_edges.
shares_personashares_competitorshares_metricdepends_on_productcannibalisessucceeds{product_id}/{node_id}. They are declared in the cross_edges array of a UPGPortfolioDocument, not inside individual product graphs. See Portfolio for the full model.