---
sourceDocument: Brazil API Reference
sourceDocumentLink: https://www.servicenow.com/docs/r/api-reference

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UI pages and macros

# UI pages and macros {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Use UI pages to create custom pages for an application and UI macros for custom controls or interfaces.

Every UI Page is a [Jelly](https://www.servicenow.com/docs/zx2FfCBqMV7zJHBCNYFWGQ "Use Jelly to turn XML into HTML.") template. Jelly turns XML into executable code. A UI Page works similar to how an index.html file is used in an AngularJS application. Jelly tags in the HTML field of the UI Page form contain AngularJS
logic.

Creating [UI macros](https://www.servicenow.com/docs/cDweBrBGAcWdgh90UCgDJQ#c_UIMacros "UI macros are discrete scripted components administrators can add to the user interface.") requires knowledge of Jelly script. Review the existing UI macros for examples and suggested approaches. Those who want to build custom interfaces with JavaScript technologies should consider Service Portal as an
alternative.
* **[UI pages](https://www.servicenow.com/docs/T1RVUdOgwAdn_SivWY8PcA#r_UIPages)**   
  UI pages can be used to create and display forms, dialogs, lists, and other UI components.
* **[UI macros](https://www.servicenow.com/docs/cDweBrBGAcWdgh90UCgDJQ#c_UIMacros)**   
  UI macros are discrete scripted components administrators can add to the user interface.
* **[Jelly tags](https://www.servicenow.com/docs/zx2FfCBqMV7zJHBCNYFWGQ)**   
  Use Jelly to turn XML into HTML.
* **[HTML syntax editor](https://www.servicenow.com/docs/354hAD5lc7uPPMub2rpCgQ)**   
  The HTML syntax editor provides support for editing HTML and Jelly scripts and defines what's rendered when the page is displayed. The HTML syntax editor can contain either static XHTML or dynamically generated content defined as Jelly, and can call script includes and UI Macros.