Try it free

Targeting

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

Every document has a target that tells UA which app, entity type, or Inventory Explorer instance it applies to. When UA needs to render a given entity type (or Inventory Explorer type), it looks up documents whose target matches, and fetches only those.

This page covers the Target union and its four shapes: EntityDetailsDefinitionTarget, EntityDetailsInjectionTarget, InvExDefinitionTarget, and InvExInjectionTarget.

Shared fields

All target shapes extend a common base:

PropertyTypeRequiredDescription

app

string

yes

Dynatrace App ID this document applies to (for example, dynatrace.infraops). Use '*' to target all apps — see the note below.

invExId

string

no

Inventory Explorer ID. Only needed when an app renders more than one Inventory Explorer instance.

Using the '*' wildcard — a wildcard app: '*' registers a document for every app instead of a single one. It is intended mainly for Entity Details documents. Avoid it for InvExTypeDefinition documents: a wildcard InvEx type would appear in every app's Inventory Explorer, so as more apps adopt UA your extension's content could surface in apps where it doesn't belong. Prefer targeting a specific app. Today the only app that serves UA documents is the Infrastructure & Operations app (dynatrace.infraops).

EntityDetailsDefinitionTarget

PropertyTypeDescription

nodeType

string

Smartscape node type this document defines the layout for (for example, dt.entity.host).

target: {
  app: 'dynatrace.infraops',
  nodeType: 'dt.entity.host',
}

EntityDetailsInjectionTarget

PropertyTypeDescription

nodeType

string

Smartscape node type to inject into.

tabId

string (optional)

Inject into a specific existing tab. Omit this when the injected content is itself a new Tab.

target: {
  app: 'dynatrace.infraops',
  nodeType: 'dt.entity.host',
  tabId: 'overview',
}

InvExDefinitionTarget

PropertyTypeDescription

invExType

string (optional)

Parent Inventory Explorer type/subtype ID. Leave empty to define a new top-level type; set it to define a subtype nested under an existing type.

target: {
  app: 'dynatrace.infraops',
  invExType: 'Compute',
}

InvExInjectionTarget

PropertyTypeDescription

invExType

string

Inventory Explorer type/subtype to inject content into.

target: {
  app: 'dynatrace.infraops',
  invExType: 'dt.entity.host',
}

See also

  • Document types
  • Elements overview
Related tags
ExtensionsExtensionsInfrastructure Observability