Base URL of the creative agent that provides this format
Human-readable format name
OptionaldescriptionPlain text explanation of what this format does and what assets it requires
Optionalexample_Optional URL to showcase page with examples and interactive demos of this format
Optionalaccepts_List of parameters this format accepts in format_id. Template formats define which parameters (dimensions, duration, etc.) can be specified when instantiating the format. Empty or omitted means this is a concrete format with fixed parameters.
OptionalrendersSpecification of rendered pieces for this format. Most formats produce a single render. Companion ad formats (video + banner), adaptive formats, and multi-placement formats produce multiple renders. Each render specifies its role and dimensions.
OptionalassetsArray of all assets supported for this format. Each asset is identified by its asset_id, which must be used as the key in creative manifests. Use the 'required' boolean on each asset to indicate whether it's mandatory.
Discriminator indicating this is a repeatable asset group
Identifier for this asset group (e.g., 'product', 'slide', 'card')
Whether this asset group is required. If true, at least min_count repetitions must be provided.
Minimum number of repetitions required (if group is required) or allowed (if optional)
Maximum number of repetitions allowed
Optionalselection_mode?: "sequential" | "optimize"How the platform uses repetitions of this group. 'sequential' means all items display in order (carousels, playlists). 'optimize' means the platform selects the best-performing combination from alternatives (asset group optimization like Meta Advantage+ or Google Pmax).
Assets within each repetition of this group
OptionaldeliveryDelivery method specifications (e.g., hosted, VAST, third-party tags)
Optionalsupported_List of universal macros supported by this format (e.g., MEDIA_BUY_ID, CACHEBUSTER, DEVICE_ID). Used for validation and developer tooling. See docs/creative/universal-macros.mdx for full documentation.
Optionalinput_Array of format IDs this format accepts as input creative manifests. When present, indicates this format can take existing creatives in these formats as input. Omit for formats that work from raw assets (images, text, etc.) rather than existing creatives.
Optionaloutput_Array of format IDs that this format can produce as output. When present, indicates this format can build creatives in these output formats (e.g., a multi-publisher template format might produce standard display formats across many publishers). Omit for formats that produce a single fixed output (the format itself).
Optionalformat_Optional standard visual card (300x400px) for displaying this format in user interfaces. Can be rendered via preview_creative or pre-generated.
Asset manifest for rendering the card, structure defined by the format
OptionalaccessibilityAccessibility posture of this format. Declares the WCAG conformance level that creatives produced by this format will meet.
Optionalrequires_accessible_assets?: booleanWhen true, all assets with x-accessibility fields must include those fields. For inspectable assets (image, video, audio), this means providing accessibility metadata like alt_text or captions. For opaque assets (HTML, JavaScript), this means providing self-declared accessibility properties.
Optionalsupported_Disclosure positions this format can render. Buyers use this to determine whether a format can satisfy their compliance requirements before submitting a creative. When omitted, the format makes no disclosure rendering guarantees — creative agents SHOULD treat this as incompatible with briefs that require specific disclosure positions. Values correspond to positions on creative-brief.json required_disclosures.
Optionaldisclosure_Structured disclosure capabilities per position with persistence modes. Declares which persistence behaviors each disclosure position supports, enabling persistence-aware matching against provenance render guidance and brief requirements. When present, supersedes supported_disclosure_positions for persistence-aware queries. The flat supported_disclosure_positions field is retained for backward compatibility. Each position MUST appear at most once; validators and agents SHOULD reject duplicates.
Persistence modes this position supports
Optionalformat_Optional detailed card with carousel and full specifications. Provides rich format documentation similar to ad spec pages.
Asset manifest for rendering the detailed card, structure defined by the format
Optionalreported_Metrics this format can produce in delivery reporting. Buyers receive the intersection of format reported_metrics and product available_metrics. If omitted, the format defers entirely to product-level metric declarations.
Creative format definition.
Extends the official Format type from the schema with an additional agent_url field for convenience when working with creative agents.