From Schema.org

This guide helps you understand the relationship between Schema.org and Yuba Schema, convert existing LocalBusiness markup, and run both in parallel.

---

When to Use This Guide

• You have JSON-LD LocalBusiness markup on your site and want to also use Yuba for AI discovery

• You want to understand how Yuba Schema maps to Schema.org

• You want to run both Schema.org (for search engines) and Yuba (for AI platforms) side by side

Key Principle

Schema.org and Yuba complement each other. Schema.org is optimized for web search crawlers. Yuba is optimized for AI platforms. You can — and should — use both.

---

Field Mapping: Schema.org ↔ Yuba

Schema.org Property	Yuba Field	Notes
name	name	Direct mapping
description	description	Yuba supports longer, AI-optimized descriptions
address (PostalAddress)	address (street, city, state, country, postalCode)	Flatten PostalAddress to Yuba fields
geo (GeoCoordinates)	coordinates (lat, lon)	Direct mapping
telephone	phone	Direct mapping
email	email	Direct mapping
url	website	Direct mapping
openingHoursSpecification	hours	Convert from Schema.org format (dayOfWeek, opens, closes) to Yuba format (day keys with open/close)
image	logo (primary), photos (array)	Schema.org uses single image; Yuba separates logo and photos
priceRange	(not directly mapped)	Can include in description or services
aggregateRating	averageRating, totalReviews	Separate fields in Yuba
@type (e.g. Restaurant)	category	Map Schema.org subtypes to Yuba categories
hasOfferCatalog / makesOffer	services (name, description)	Simplified in Yuba
(no equivalent)	exclusiveContent, insiderTips	Yuba-only: AI-exclusive content fields
(no equivalent)	Upstream metrics	Yuba-only: AI visibility analytics

Category Mapping

Schema.org @type	Yuba Category
Restaurant	restaurants
LodgingBusiness	hospitality
MedicalBusiness	healthcare
ProfessionalService	professional_services
Store / LocalBusiness	retail (or default local_business)

---

Code Example: Schema.org → Yuba Profile

Schema.org JSON-LD (Input)

{
  "@context": "https://schema.org",
  "@type": "Restaurant",
  "name": "Sakura Sushi",
  "description": "Authentic Japanese sushi restaurant in downtown Portland.",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "123 Main St",
    "addressLocality": "Portland",
    "addressRegion": "OR",
    "postalCode": "97201",
    "addressCountry": "US"
  },
  "geo": {
    "@type": "GeoCoordinates",
    "latitude": 45.5155,
    "longitude": -122.6789
  },
  "telephone": "[phone]",
  "url": "https://sakurasushi.com",
  "openingHoursSpecification": [
    {
      "@type": "OpeningHoursSpecification",
      "dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
      "opens": "11:00",
      "closes": "22:00"
    }
  ],
  "image": "https://sakurasushi.com/logo.jpg"
}

Equivalent Yuba Profile

{
  "name": "Sakura Sushi",
  "description": "Authentic Japanese sushi restaurant in downtown Portland.",
  "category": "restaurants",
  "address": {
    "street": "123 Main St",
    "city": "Portland",
    "state": "OR",
    "postalCode": "97201",
    "country": "US"
  },
  "coordinates": {
    "lat": 45.5155,
    "lon": -122.6789
  },
  "phone": "[phone]",
  "website": "https://sakurasushi.com",
  "hours": {
    "monday": { "open": "11:00", "close": "22:00" },
    "tuesday": { "open": "11:00", "close": "22:00" },
    "wednesday": { "open": "11:00", "close": "22:00" },
    "thursday": { "open": "11:00", "close": "22:00" },
    "friday": { "open": "11:00", "close": "22:00" }
  },
  "logo": "https://sakurasushi.com/logo.jpg"
}

---

Best Practices

Run Both

Keep Schema.org on your website for search engines. Use Yuba for AI discovery. They serve different audiences and complement each other.

Use Specific Types

Prefer specific Schema.org types (Restaurant, LodgingBusiness) and specific Yuba categories over generic LocalBusiness / local_business. More specific types improve both search and AI discovery.

Validate

• Schema.org: Validate with Google Rich Results Test

• Yuba: Validate through the platform's profile validation (built into the dashboard)

Export JSON-LD from Yuba (Planned)

Yuba will support exporting your profile as Schema.org-compatible JSON-LD that you can embed on your website. This means you can manage your business data in Yuba and automatically keep your Schema.org markup in sync.

---

Get Help

• GitHub Discussions

• Email: [e-mail]

---

Last Updated: February 22, 2026