A short instructional video explaining a concept, feature, or workflow.
A help video is a short instructional clip that shows a user how to do one thing: set up an account, connect an integration, fix a common error. It trades the precision of written documentation for the bandwidth of demonstration. The catch is that the same recording which makes a featureFeatureProduct SpecificationA product capability or featureView reference → obvious today goes stale the moment the interface it captured changes.
Screencast tutorialsTutorialCustomer EducationA step-by-step tutorialView reference → are nearly as old as consumer software, but they became a standard support channel once screen-recording tools and cheap video hosting made them quick to produce. The case for video rests on a simple observationObservationUser ResearchA specific behaviour or statement observedView reference →: some tasksTaskProduct SpecificationA unit of work within a story or epicView reference → are easier to watch than to read, because seeing the cursor move through a real interface removes the ambiguity that prose leaves behind.
The cost structureCost StructureBusiness ModelA cost category or structureView reference → cuts the other way. A written article can be edited in a minute when a button moves; a video has to be re-recorded, re-narrated, and re-uploaded. That maintenance burden is why mature help centres pair the two, using video for the show-don't-tell moments and written articles for anything that changes often or needsNeedUserA user need, pain, desire, or constraintView reference → to be searched, skimmed, and translated. The discipline is matching the medium to how volatile and how scannable the content is.
A team finds that 40 percent of new users abandon setup at the integration step. A written guide already exists, but the drop-off persists. They record a 90-second help video walking through the exact screens, and embed it on the setup page and in the onboarding email. Completion at that step climbs from 60 to 82 percent over the next month. Then the integration UI is redesigned, the video silently goes out of date, and support ticketsSupport TicketCustomer SuccessCustomer support request or issueView reference → referencing "the video doesn't match my screen" appear within a fortnight. The win was real; so was the maintenance bill that came due.
In the Unified Product Graph, a help video sits in the education region with three connections: an Education ProgramCustomer EducationA customer education programView reference → presents it (education_programEducation Programdemonstrates viaHelp Videohierarchy), it documents a specific education_program_demonstrates_via_help_videoScreenExperience DesignA distinct screen or view in the productView reference → (screenHelp VideodocumentsScreencross-domain), and a help_video_documents_screenMarketplace ListingPartners & EcosystemA marketplace listingView reference → can reference it (marketplace_listingMarketplace ListingreferencesHelp Videocross-domain). The edge to a screen is the one that earns its keep: because the video is linked to the exact interface it captured, a change to that screen flags every video that documented it, turning the staleness problem from a surprise in the support queue into a tracked dependencyDependencyTeam & OrganisationA cross-team or system dependencyView reference →.marketplace_listing_references_help_video
Type-specific fields on BaseNode
video_typestringPurpose of the video
duration_secondsnumberDuration of the video in seconds
viewsnumberTotal number of views
urlstringURL where the video is hosted
idstringrequiredUnique identifier (UUID)
typeNodeTyperequiredDiscriminator for the entity type
titlestringrequiredDisplay name
descriptionstringOptional detailed description
statusstringLifecycle status
tagsstring[]Freeform tags for filtering
4 phases — initial: draft · template: PUBLISHING
3 edge types connected to this entity.
education_program_demonstrates_via_help_videohelp_video_documents_screenmarketplace_listing_references_help_video