Try it free

Custom card

  • Latest Dynatrace
  • Reference
  • 2-min read
  • Published Jul 13, 2026

type: 'custom'

A placeholder that resolves to app-provided content at runtime. Use this when a document needs to reference content that only the consuming app can supply.

Fields

In addition to the shared CoreElement fields (see Elements overview):

PropertyTypeDescription

customCardType

string (optional)

Identifier used to match this placeholder to the app's registered content slot.

cardProps

Record<string, unknown> (optional)

Static properties forwarded to the custom card's content, readable at runtime via the component context.

How it resolves

At runtime, the app registers React content for a given id, customCardType, or schemaKey (via a content-slot API such as <UAContent.CustomCard>). The document only carries the placeholder and static cardProps — never the React content itself, since documents must stay JSON-serializable.

Example

{
"type": "custom",
"id": "my-team-widget",
"customCardType": "team-widget",
"cardProps": { "teamId": "platform-team" }
}

See also

  • Elements overview
Related tags
ExtensionsExtensionsInfrastructure Observability