Try it free

Custom card

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

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.

cardTitle

string (optional)

Title displayed in the card header.

cardDescription

string (optional)

Description displayed below the card title.

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",
"cardTitle": "Platform team ownership",
"cardDescription": "Shows the team responsible for this entity, their on-call schedule, and open incidents.",
"cardProps": { "teamId": "platform-team" }
}

See also

  • Elements overview
Related tags
ExtensionsExtensionsInfrastructure Observability