{"id":34005,"date":"2026-01-15T15:12:32","date_gmt":"2026-01-15T15:12:32","guid":{"rendered":"https:\/\/crocoblock.com\/knowledge-base\/?post_type=article&p=34005"},"modified":"2026-01-15T15:12:35","modified_gmt":"2026-01-15T15:12:35","slug":"macros-guide","status":"publish","type":"article","link":"https:\/\/crocoblock.com\/knowledge-base\/jetengine\/macros-guide\/","title":{"rendered":"Macros Guide"},"content":{"rendered":"\n

A macro is a piece of a string that gets replaced with a certain value depending on the purpose of the macro. In other words, a macro is a variable that can return different values based on the context.<\/p>\n\n\n\n

We have created special macros for the JetEngine<\/em><\/a> plugin, allowing certain functions. Using these macros in JetEngine<\/em> <\/strong>tools, you will be able to query and display dynamic information on the page.<\/p>\n\n\n\n

Below, we will cover the ways to use the macros and the locations that support them. Also, we will explain the purpose of each macro and the value that the macro returns.<\/p>\n\n\n\n

Supported Locations<\/h2>\n\n\n\n

There are global macros that can be used in any part of the website, and there are macros for specific areas. <\/p>\n\n\n\n

Most of the macros listed here are global and can be used in the Query Builder<\/a><\/strong>, Dynamic Visibility<\/a> <\/strong>settings, the Label <\/strong>field of the Dynamic Link <\/strong>widget<\/a>\/block<\/a>, the Query Arguments <\/strong>area of the Dynamic Link <\/strong>widget\/block, and the Customize field output <\/strong>area of the Dynamic Field <\/strong>widget<\/a>\/block<\/a>, if not specified otherwise.<\/p>\n\n\n\n

There are macros for specific areas. In the Macros for JetBooking<\/a> part, there are macros that can be used in the settings of the iCal<\/strong> synchronization of the JetBookings <\/em>plugin. In the Macros for Repeater<\/a> part, we list macros that should be used in the Dynamic Repeater <\/strong>widget\/block of the JetEngine <\/em>plugin. The part Macros for Send Email in Forms<\/a> lists macros that are only functioning in the Send Email post-submit action<\/strong> of the JetEngine <\/em>Forms <\/strong>module.<\/p>\n\n\n\n

Macros have a body, a context value, and a fallback value. It is highly recommended to use the Macros Generator<\/strong><\/a> <\/strong>tool of the JetEngine <\/em>plugin to auto-generate a macro conveniently based on the provided settings. Copy the generated macro and use it in places that support manually typed-in macros (the Label <\/strong>field of the Dynamic Link <\/strong>widget\/block, the Query Arguments <\/strong>area of the Dynamic Link <\/strong>widget\/block, and the Customize field output <\/strong>area of the Dynamic Field <\/strong>widget\/block).<\/p>\n\n\n\n

\"jetengine<\/a><\/div>\n\n\n\n

Also, mind that the same macros can be found by pushing the \u201cDynamic Tags<\/a><\/strong>\u201d button. In Elementor, the “Macros” dynamic tag can be used only in JetEngine <\/em>widgets like Listing Grid<\/strong> or Dynamic Link<\/strong> and features that allow dynamic tags usage (for example, in the Posts Query <\/strong>settings section).<\/p>\n\n\n\n

\"macros<\/a><\/div>\n\n\n\n

In Gutenberg, macros can be found by clicking the \u201cDynamic Tags<\/strong>\u201d button and navigating to the Content > Data Source <\/strong>tab to select the “Custom Data” SOURCE<\/strong>. The SELECT DATA TO SHOW <\/strong>drop-down list contains the macros.<\/p>\n\n\n\n

\"using<\/a><\/div>\n\n\n
<\/svg><\/div>
Warning<\/div>

Macros in the Dynamic Visibility<\/strong> feature and in custom queries of Query Builder<\/strong> should be selected by clicking on the \u201cDynamic Tags<\/strong>\u201d button only. The manually typed macros are not supported.<\/p><\/div><\/div>\n\n\n\n

Frequently Used Macros<\/h2>\n\n\n\n
<\/svg><\/div>
Warning<\/div>

If you are looking for more information on how to use macros in the Query Builder, check the related article \u2018Macros in Query Builder\u2019<\/a>. It also lists real usage examples. <\/p><\/div><\/div>\n\n\n\n

%current_categories%<\/strong> (\u201cCurrent categories\u201d) <\/strong>\u2014 this macro returns current post categories. To show posts related by categories, use this macro in the Terms <\/strong>field of the Tax Query <\/strong>tab of settings in the Posts Query<\/strong>.<\/p>\n\n\n

<\/svg><\/div>
Warning<\/div>

The %current_categories%<\/strong> macro works only with the default WordPress categories.<\/p><\/div><\/div>\n\n\n\n

%current_tags% (\u201cCurrent tags\u201d)<\/strong> \u2014 returns current post tags. To show posts related by tags, use this macro in the Terms <\/strong>field of the Tax Query <\/strong>tab of settings in the Posts Query<\/strong>.<\/p>\n\n\n

<\/svg><\/div>
Warning<\/div>

The %current_tags%<\/strong> macro works only with the default WordPress tags.<\/p><\/div><\/div>\n\n\n\n

%current_terms%<\/strong> (\u201cCurrent terms\u201d<\/strong>) \u2014 returns current post terms; you may specify a taxonomy to return terms from \u2013 %current_terms|taxonomy_slug%. <\/p>\n\n\n\n

If one has a custom taxonomy, this macro helps query the current terms to display the posts related by the terms on the Single post\u2019s page. Check the \u201cMacros for Query Builder\u201d guide to learn how to display posts related by terms on the Single post\u2019s page<\/a>.<\/p>\n\n\n\n

%queried_term%<\/strong> (\u201cQueried term\u201d<\/strong>) \u2014 returns the ID of the term on its archive page or in a Listing Item of Terms.<\/p>\n\n\n\n

Check the \u201cMacros for Query Builder\u201d guide to learn how to display related posts on the taxonomy archive page<\/a> using this macro.<\/p>\n\n\n\n

%current_id%<\/strong> (\u201cCurrent ID\u201d<\/strong>) \u2014 returns the current post ID. Use this macro in a Posts Query <\/strong>to include or exclude the current post from the query results<\/a>.<\/p>\n\n\n\n

%title%<\/strong> (\u201cTitle\u201d<\/strong>) \u2014 type in this macro in the Label <\/strong>field of the Dynamic Link<\/strong> widget to get the name of the current post and make it clickable.<\/p>\n\n\n\n

%object_id% <\/strong>(\u201cObject ID\u201d<\/strong>) \u2014 get the ID of the current object by pasting the macro in the Label <\/strong>field of the Dynamic Link <\/strong>widget.<\/p>\n\n\n\n

%field_value% <\/strong>(\u201cField value\u201d<\/strong>) \u2014 choose the needed field from the Source <\/strong>drop-down list and add this macro to the Label <\/strong>field in the Dynamic Link<\/strong> widget to get the field’s value, set to be the Source <\/strong>of Dynamic Link<\/strong>. For example, if you use a meta field with URL as a link source, %field value% returns this link. <\/p>\n\n\n\n

%jet_engine_field_name|meta-field|field_name% <\/strong>\u2014 paste this macro in the Label <\/strong>field of the Dynamic Link <\/strong>widget to get the JetEngine <\/strong>meta field key name. Use the actual field name instead of the \u2018meta-field\u2019 value.<\/p>\n\n\n\n

%jet_engine_field_name|meta-field|field_value% <\/strong>\u2014 the similar macro to the previous one that should also be pasted in the Label <\/strong>field. Though, this macro returns the value of the meta field and not its name. Don\u2019t forget to change the \u2018meta-field\u2019 value into the actual meta field key.<\/p>\n\n\n\n

%current_meta|field-name%<\/strong> (\u201cCurrent meta value\u201d<\/strong>) \u2014 returns the value of the meta field of the current post. For example, use this macro in the Label <\/strong>field of the Dynamic Link <\/strong>widget if you want to display the value of the specific field.<\/p>\n\n\n\n

Mind that macro should look like this: %current_meta|field-name%, where ‘field-name’ is the name of the field you want to pull the data from. <\/p>\n\n\n\n

Also, there\u2019s an opportunity to display posts that have the same meta value as the current post<\/a>.<\/p>\n\n\n\n

%current_meta_string|field-name% <\/strong>(\u201cCurrent meta value as string\u201d<\/strong>) \u2014 with this macro, you can get comma-separated values from the current post\u2019s meta fields that contain arrays. You can use it with the multiple select options or checkbox type with the Save as array option enabled. Also, it is possible to use this macro to display posts from the Posts <\/strong>meta field<\/a> using this macro.<\/p>\n\n\n\n

%today% <\/strong>(\u201cToday\u201d<\/strong>) \u2014 returns today\u2019s date as a timestamp.<\/p>\n\n\n\n

%str_to_time|datetime-string% <\/strong>(\u201cString to timestamp\u201d<\/strong>) <\/strong>\u2014 turns the value into the timestamp. Paste the needed option instead of the \u2018\u2019datetime-string\u201d. For instance, you can paste %str_to_time|10 September 2000% <\/strong>to return the timestamp of this date, or %str_to_time|+ 1 day% <\/strong>to get tomorrow\u2019s date as a timestamp.<\/p>\n\n\n\n

%current_date|format% <\/strong>(\u201cCurrent Date<\/strong>\u201d) \u2014 returns the current day in the specified format. To use this macro correctly, you need to pass the \u2018format\u2019 parameter, which accepts these values:<\/p>\n\n\n\n