Render the property value of an ancestor of this document, for the first ancestor that matches the specified document type.

Audience
Tags
Type
Dynamic Navigation
Since
1.16

The Ancestor Property Macro allows template authors to reference a document property of an ancestor document. If such a document is moved to another document tree, the referenced parent property is automatically updated.

This macro is especially useful to add the name of an ancestor's document to the properties table to be printed.

Properties

The macro provides the following properties.

Property Name

The name of the property in the ancestor document to references.

Ancestor Doctype

The name of the type of the ancestor document to be actually considered a ancestor. The property of the first matching ancestor is rendered.

An ancestor is a parent or one of the parents of that parent.

If the ancestor doctype is not specified, the ancestor is required to have the same type as the referencing document.

Default Value

A default value to render, if the document has no ancestor of the specified doctype. Usually this property is left blank.