Unhead
Nuxt
You're viewing Unhead v3 beta documentation. Install with unhead@beta
Schema
On this page

Schema.org Service

Type: defineService(input?: Service)

Describes a service offering (distinct from physical products).

Useful Links

Required properties

  • name string
    The name of the service.

Recommended Properties

  • serviceType string
    The type of service (e.g., "web design", "plumbing", "consulting", "legal advice").
  • provider NodeRelations<Person | Organization | string>
    Who provides the service. Resolves to Person or Organization.
  • areaServed string
    Geographic area where the service is provided (e.g., "United States", "San Francisco", "Global").
  • offers NodeRelations<Offer>
    Pricing information for the service. Resolves to Offer.

Defaults

Sub-Types

  • BroadcastService
  • CableOrSatelliteService
  • FinancialService
  • FoodService
  • GovernmentService
  • TaxiService
  • Telecom

You can specify a subtype using the @type property.

Examples

Minimal

defineService({
  name: 'Web Design Services',
  serviceType: 'Web Design',
})

With Pricing

defineService({
  name: 'Professional Web Design',
  serviceType: 'Web Design',
  description: 'Custom website design and development services',
  provider: {
    name: 'Design Studio Inc.',
  },
  areaServed: 'United States',
  offers: {
    price: 5000,
    priceCurrency: 'USD',
    description: 'Starting price for basic website',
  },
})

Complete

defineService({
  'name': 'Professional Consulting Services',
  '@type': 'FinancialService',
  'serviceType': 'Financial Consulting',
  'description': 'Expert financial advisory and consulting for businesses',
  'url': 'https://example.com/services/consulting',
  'provider': {
    name: 'Expert Consultants LLC',
    url: 'https://example.com',
  },
  'areaServed': ['United States', 'Canada', 'United Kingdom'],
  'category': 'Consulting',
  'image': 'https://example.com/services/consulting-hero.jpg',
  'offers': {
    price: 250,
    priceCurrency: 'USD',
    description: 'Hourly consulting rate',
  },
  'aggregateRating': {
    ratingValue: 4.8,
    ratingCount: 120,
  },
  'review': [
    {
      author: 'Jane Smith',
      reviewRating: 5,
      reviewBody: 'Excellent service, highly recommended!',
    },
  ],
  'termsOfService': 'https://example.com/terms',
  'slogan': 'Your success is our mission',
})

Types

export interface ServiceChannel {
  '@type'?: 'ServiceChannel'
  'serviceUrl'?: string
  'servicePhone'?: string
  'serviceLocation'?: string
  'availableLanguage'?: string | string[]
}

type ValidServiceSubTypes = 'Service' | 'BroadcastService' | 'CableOrSatelliteService' | 'FinancialService' | 'FoodService' | 'GovernmentService' | 'TaxiService' | 'Telecom'

export interface ServiceSimple extends Thing {
  '@type'?: Arrayable<ValidServiceSubTypes>
  'name': string
  'description'?: string
  'serviceType'?: string
  'provider'?: NodeRelation<Person | Organization>
  'areaServed'?: string | unknown
  'availableChannel'?: ServiceChannel | ServiceChannel[]
  'audience'?: unknown
  'category'?: string | string[]
  'hasOfferCatalog'?: unknown
  'offers'?: NodeRelations<Offer>
  'aggregateRating'?: NodeRelation<AggregateRating>
  'review'?: NodeRelations<Review>
  'image'?: NodeRelations<string | ImageObject>
  'logo'?: NodeRelations<string | ImageObject>
  'url'?: string
  'termsOfService'?: string
  'slogan'?: string
  'brand'?: NodeRelation<Organization>
}

Related Schemas

Edit this page
Markdown For LLMs
Did this page help you?