A fluent builder types and ld+json generator

A fluent builder types and ld+json generator

Latest Version on Packagist Software License Build Status SensioLabsInsight Quality Score StyleCI Total Downloads

spatie/schema-org provides a fluent builder for all types and their properties. The code in src is generated from’s RFDa standards file, so it provides objects and methods for the entire core vocabulary. The classes and methods are also fully documented as a quick reference.

use Spatie\SchemaOrg\Schema;

$localBusiness = Schema::localBusiness()
    ->email('[email protected]')

<script type="application/ld+json">
    "@context": "http:\/\/",
    "@type": "LocalBusiness",
    "name": "Spatie",
    "email": "[email protected]",
    "contactPoint": {
        "@type": "ContactPoint",
        "areaServed": "Worldwide"


You’re free to use this package (it’s MIT-licensed), but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.

Our address is: Spatie, Samberstraat 69D, 2060 Antwerp, Belgium.

The best postcards will get published on the open source page on our website.


You can install the package via composer:

composer require spatie/schema-org


All types can be instantiated though the Spatie\SchemaOrg\Schema factory class, or with the new keyword.

$localBusiness = Schema::localBusiness()->name('Spatie');

// Is equivalent to:

$localBusiness = new LocalBusiness();

Types can be converted to an array or rendered to a script.



echo $localBusiness; // Same output as `toScript()`

There’s no full API documentation for types and properties. You can refer to the source or to the website.

If you don’t want to break the chain of a large schema object, you can use the if method to conditionally modify the schema.

use Spatie\SchemaOrg\LocalBusiness;
use Spatie\SchemaOrg\Schema;

$business = ['name' => 'Spatie'];

$localBusiness = Schema::localBusiness()
    ->if(isset($business['email']), function (LocalBusiness $schema) {

I recommended double checking your structured data with Google’s structured data testing tool

Advanced usage

If you’d need to set a custom property, you can use the setProperty method.

$localBusiness->setProperty('foo', 'bar');

If you’d need to retrieve a property, you can use the getProperty method. You can optionally pass in a second parameter to provide a default value.

$localBusiness->getProperty('name'); // 'Spatie'
$localBusiness->getProperty('bar'); // null
$localBusiness->getProperty('bar', 'baz'); // 'baz'

All properties can be retrieved as an array with the getProperties method.

$localBusiness->getProperties(); // ['name' => 'Spatie', ...]

Context and type can be retrieved with the getContext and getType methods.

$localBusiness->getContext(); // ''
$localBusiness->getType(); // 'LocalBusiness'

Known Issues

Type inheritance

The spec rdfa document that’s used to generate this code uses single inheritance for the types. However, the spec on uses multiple inheritance in some cases. Read the docs and use Google’s structured data testing tool to ensure you’re on the right track!

For example, according to the rdfa, a LocalBusiness inherits properties from Organization. However, if you visit the spec page on, it inherits properties from Organization and Place. The current solution is by manually specifying properties on the item, as described above in advanced usage.


    // `address` is part of `Organization`, so the method exists
    ->address(/* ... */)

    // `openingHoursSpecification` is part of `Place`, so we need to manually add it
    ->setProperty('openingHoursSpecification', /* ... */);

Other minor issues

  • Some docblocks have some formatting issues (PR’s welcome!)
  • The Float type isn’t available since it’s a reserved keyword in PHP
  • The Physician type isn’t available since it extends a type from the health extension spec


Please see CHANGELOG for more information what has changed recently.


$ composer test


Please see CONTRIBUTING for details.


If you discover any security related issues, please email [email protected] instead of using the issue tracker.


About Spatie

Spatie is a webdesign agency based in Antwerp, Belgium. You’ll find an overview of all our open source projects on our website.


The MIT License (MIT). Please see License File for more information.

Related Repositories



A fluent builder types and ld+json generator ...



PHP Model Scaffolding from vocabulary ...



Validation of compliant schemas. ...


html-schema API for Ruby (Microdata and Microformats under one API) ...

JSON Schema website ...