Index of every page on this site: llms.txt
Unhead
TypeScript
Schema

Service Schema Markup: JSON-LD Examples and API

Copy for LLMs
On this page

Service structured data describes a service that a person or organization provides, such as web design, plumbing, or consulting. It names the service type, the provider, the area served, and the price.

JSON-LD Example

Unhead renders this JSON-LD for the pricing example. It resolves offers to an Offer with default availability and price validity.

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@id": "https://example.com/blog/my-article#service",
      "@type": "Service",
      "areaServed": "United States",
      "description": "Custom website design and development services",
      "name": "Professional Web Design",
      "serviceType": "Web Design",
      "offers": {
        "@type": "Offer",
        "availability": "https://schema.org/InStock",
        "price": 5000,
        "priceCurrency": "USD",
        "description": "Starting price for basic website",
        "priceValidUntil": "2027-12-30T00:00:00.000Z"
      },
      "provider": {
        "@type": "Organization",
        "name": "Design Studio Inc."
      }
    }
  ]
}

Schema.org Service

Type: defineService<T extends Record<string, any>>(input?: Service & T)

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 NodeRelation<Person | Organization>
    Who provides the service. If omitted, Unhead references the primary identity. An explicitly supplied provider is passed through, so include its @type or use a nested definePerson() or defineOrganization() helper.
  • areaServed string
    Geographic area where the service is provided (e.g., "United States", "San Francisco", "Global").
  • offers NodeRelations<Offer>
    Unhead resolves the pricing information as an Offer.

Defaults

  • @type: Service
  • @id: ${canonicalUrl}#service
  • name: page title from resolved metadata
  • description: resolved page description
  • image: resolved page image
  • provider: ID reference to the primary identity, when one exists
  • brand: ID reference to the primary identity, when one exists
  • mainEntityOfPage: ID reference to the WebPage, when one exists

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: {
    '@type': 'Organization',
    name: 'Design Studio Inc.',
  },
  areaServed: 'United States',
  offers: {
    price: 5000,
    priceCurrency: 'USD',
    description: 'Starting price for basic website',
  },
})

Detailed example

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': {
    '@type': 'Organization',
    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: {
        ratingValue: 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<ImageObject | string>
  'logo'?: NodeRelations<ImageObject | string>
  'url'?: string
  'termsOfService'?: string
  'slogan'?: string
  'brand'?: NodeRelation<Organization>
}

Related Schemas

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

Recipe Schema Markup: JSON-LD Example and API

Add recipe schema markup with defineRecipe(). See Recipe JSON-LD with ingredients and steps, plus the name and image that Google requires.

SoftwareApplication Schema - JSON-LD Guide & Examples

Implement SoftwareApplication structured data with Unhead. See JSON-LD examples for app listings, ratings, pricing, and platform compatibility.