Macros

In Umbraco, macros are small building blocks of functionality that can be used in an editor. Each macro encompasses a piece of functionality and provides an interface to be able to modify the macro as per 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 less complex manner.

The macros available to you differ from system to system. Contact your system administrator to find out which macros are available to you and what they do.

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. The Select Macro tree opens on the right-side of the editor.

  3. Select a macro to insert or enter the macro name in the Search bar.

    Macro Picker

  4. Configure the macro as required.

  5. Click Submit to insert the macro. The macro is displayed in the editor with a dotted border.

    Macro Editor

Important: Note:

If there are no macros, you can Create Macros. The above image is an example of macros available when a Starter Kit package is installed.

Editing macros

You can edit the macro values after it has been added to the rich text editor:

  1. Highlight the macro in the rich text editor.
  2. Click the Insert Macro button. The Select Macro tree opens on the right-side of the editor.
  3. Here, you can edit the configuration as per your requirement.

Removing macros

To remove a macro:

  1. Highlight the macro in the rich text editor.
  2. Press the Delete or Backspace button on your keyboard.