Macros

In Umbraco, macros are small building blocks of functionality that can be dropped into an editor. Each macro encompasses a piece of functionality and provides a simple interface to be able to modify the macro to your requirements. A macro can be anything from a contact form to an embeddable media player. The advantage of macros is that it gives editors the ability to add complex elements to the page in a simple manner.

The macros available to you differ from system to system so please see your system administrator to find out which macros are available to you and what they do. The process for adding and updating a macro is always the same.

Adding a Macro to the Page

1. Place the cursor in the editor where you want to insert your macro.
2. Click the Insert Macro button from the toolbar to open the macro properties dialog box.
3. Select a macro to insert from the Choose a macro drop-down list.
4. Configure the macro as required.
5. Click Select to insert the macro.
6. The macro is displayed in the editor with a yellow dotted border.

Editing macros

You can edit values you have inputted into a macro after it has been added to the rich text editor.

1. Highlight the macro in the rich text editor.
2. Click the macro button in the toolbar.
3. This will bring out the configuration slide out menu where you can edit any values previously added.

Removing macros

To remove a macro you highlight the macro in the rich text editor and hit the delete or backspace button on your keyboard.