[comment]: # translation:outdated

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

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

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

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

The global macro object has the following properties.

|Property|Type|Description|
|--------|----|-----------|
|globalmacroid|string|*(readonly)* ID of the global macro.|
|**macro**<br>(required)|string|Macro string.|
|**value**<br>(required)|string|Value of the macro.|

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

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

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

|Property|Type|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]: # ({/77b5c5f3-c5d988d8})