Understanding Content Type Schema
We are actively working to improve this documentation. The content you see here may be incomplete, subject to change, or may not fully reflect the current state of the feature. We appreciate your understanding as we continue to enhance our docs.
This reference document provides comprehensive coverage of how your Java content type classes map to GraphQL schema types in the GCA. Understanding this mapping is essential for crafting effective queries and mutations, as it explains the transformation from Java field definitions to GraphQL field types, how different field types are represented (primitives, references, collections, embedded objects), and what additional metadata fields the GCA automatically includes.
The GCA automatically generates GraphQL types from your content classes including support for specialized Brightspot types like StorageItem (for images and files), reference fields (for relationships between content), editorial metadata fields (workflow state, scheduling, permissions), and common patterns like unique identifiers, type discriminators, and timestamps. This document also covers inheritance and interface handling, querying nested fields and relationships, and field-level documentation derived from Javadoc comments. Use this as your reference when you need to understand what fields are available in query and mutation responses, how to access nested data, or what metadata the GCA provides automatically.