[comment]: # translation:outdated

[comment]: # ({28092341-28092341})
# > User macro object

The following objects are directly related to the `usermacro` API.

[comment]: # ({/28092341-28092341})

[comment]: # ({422b24e3-422b24e3})
### Global macro

The global macro object has the following properties.

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--------|---------------------------------------------------|-----------|
|globalmacroid|string|*(readonly)* ID of the global macro.|
|**macro**<br>(required)|string|Macro string.|
|**value**<br>(required)|string|Value of the macro.|

[comment]: # ({/422b24e3-422b24e3})

[comment]: # ({c5d988d8-c5d988d8})
### Host macro

The host macro object defines a macro available on a host or template.
It has the following properties.

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--------|---------------------------------------------------|-----------|
|hostmacroid|string|*(readonly)* ID of the host macro.|
|**hostid**<br>(required)|string|ID of the host that the macro belongs to.|
|**macro**<br>(required)|string|Macro string.|
|**value**<br>(required)|string|Value of the macro.|

[comment]: # ({/c5d988d8-c5d988d8})