Highlight discriminator properties in oneOf, allOf, anyOf objects

[spastorelli]

[linear]

RND-8182 oneOf schemas with discriminators not properly rendered

[changeset-bot]

🦋 Changeset detected

Latest commit: 406a044

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@gitbook/react-openapi	Patch
gitbook	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-nxphabpvj-gitbook.vercel.app	✅
Cloudflare	https://1e2a78d1-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-nxphabpvj-gitbook.vercel.app/url/gitbook.com/docs	https://1e2a78d1-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-nxphabpvj-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://1e2a78d1-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2 (Inspect)	👍 Changes approved	4 changed	Sep 29, 2025, 2:52 PM
v2-cloudflare (Inspect)	👍 Changes approved	8 changed	Sep 29, 2025, 2:55 PM
v2-vercel (Inspect)	👍 Changes approved	4 changed	Sep 29, 2025, 2:53 PM

[taranvohra]

I'm not sure I understand the change. What does discriminator represent?

[spastorelli]

I'm not sure I understand the change. What does discriminator represent?

@taranvohra when dealing with oneOf, allOf, anyOf schemas, the discriminator is what helps you identify which property in the alternatives objects (ie. schemas/objects listed in oneOf, allOf, anyOf) that identify the data/object type. Basically, it's the property that helps discriminate between each of the objects contained within the oneOf, allOf, anyOf list.