Advanced Configuration

For teams with developer support: lock exact share image values when a page must always use approved wording and visuals.

Use this page when a share image must use exact approved values instead of relying on what Mosaicora reads from the page.

mosaicora:og is a developer-facing block that tells Mosaicora which values should win for a default image or a page-specific variation.

Next recommended

Go to get started

Read introduction Open tutorial

What `mosaicora:og` does

Set the values you want Mosaicora to use exactly, even when the page already contains other sharing information.

mosaicora:og is the exact-value override block for Mosaicora share images.

When the same field exists in multiple places, this exact value is used first.

Version 3 uses semantic roles, so approved content maps by meaning instead of template position.

What you can set exactly

Start with the fields that matter most to the final image and add only what you need.

•
Content: content.title, content.description, and content.category.
•
People and brands: person.name, person.role, organization.name, and person.image.
•
Commerce: product.price, product.originalPrice, product.features, and offer.discount.
•
Structured values: navigation.items, analytics.metrics, and social.verified.
•
Images: image.primary and the image.secondary list.
•
Template selection: add an optional templateId from the same account as the site. Invalid or unauthorized IDs are ignored.

Full WebPage example

Use a full page-level override when the share image must be consistent and easy to review.

WebPage example

A complete v3 block with typed semantic content and image values.

<script type="application/ld+json">
{
  "@context": {
    "schema": "https://schema.org",
    "mosaicora": "https://mosaicora.io/ns#"
  },
  "@type": "WebPage",
  "name": "Advanced OG Configuration",
  "description": "Pin exact OG image values for a published page.",
  "url": "https://demo.mosaicora.io/guides/advanced-og",
  "mosaicora:og": {
    "schemaVersion": 3,
    "templateId": "6a36446a0021410e8044",
    "semanticValues": {
      "content.title": "Advanced OG Configuration",
      "content.description": "Pin exact values for the final share image",
      "person.name": "Mosaicora Team",
      "person.role": "Product",
      "organization.name": "Mosaicora Studio",
      "image.primary": "https://demo.mosaicora.io/images/og-main.png",
      "image.secondary": ["https://demo.mosaicora.io/images/og-secondary.png"]
    }
  }
}
</script>

Smaller schema-specific examples

Choose the example that matches the page type, then override only the values you care about.

Product

Pin pricing and approved product content when the page represents a product.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Mosaicora OG Generator",
  "offers": {
    "@type": "Offer",
    "price": "49",
    "priceCurrency": "USD"
  },
  "mosaicora:og": {
    "schemaVersion": 3,
    "semanticValues": {
      "content.title": "Mosaicora OG Generator",
      "content.description": "Exact pricing and branding for the product card",
      "product.price": "$49",
      "product.originalPrice": "$99"
    }
  }
}
</script>

Article

Keep editorial pages consistent across titles, authors, and metadata.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How Exact OG Values Work",
  "author": {
    "@type": "Person",
    "name": "Mosaicora Team"
  },
  "mosaicora:og": {
    "schemaVersion": 3,
    "semanticValues": {
      "content.title": "How Exact OG Values Work",
      "content.description": "The same title and author every time",
      "person.name": "Mosaicora Team",
      "person.role": "Editorial"
    }
  }
}
</script>

Organization

Lock in the brand identity for a company or product landing page.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Mosaicora",
  "url": "https://mosaicora.io",
  "logo": {
    "@type": "ImageObject",
    "url": "https://demo.mosaicora.io/logo.png"
  },
  "mosaicora:og": {
    "schemaVersion": 3,
    "semanticValues": {
      "content.title": "Mosaicora",
      "organization.name": "Mosaicora",
      "image.primary": "https://demo.mosaicora.io/logo.png"
    }
  }
}
</script>

Pin exact values deliberately

Use a smaller override when only a few approved values need to stay fixed.

Exact values example

This is a compact version you can keep close to the final output you want.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebPage",
  "mosaicora:og": {
    "schemaVersion": 3,
    "semanticValues": {
      "content.title": "Launch Checklist",
      "content.description": "The final share card should not drift",
      "organization.name": "Mosaicora Studio"
    }
  }
}
</script>

Preview and verify exact output

Check the preview after you add overrides so you can confirm the final image matches the values you set.

•
Use the preview when you want to confirm the final title, author, pricing, and brand identity.
•
Refresh the output after changes so you can verify the exact values are being used.
•
Keep the override small if you only need to pin one or two fields.

Advanced configuration editor and OG preview with the exact-value fields highlighted.