---
sourceDocument: Yokohama Build or modify applications
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Build or modify applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# Creating custom UI Pages and UI macros

# Creating custom UI Pages and UI macros {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](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/access?context=r_JellyTags&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US) 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/access?context=c_UIMacros&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US) 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/BH1dr8SHpCa9dNSDOPsBKA#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/c4j1ztTFeWAPzS5cLLjLNA#c_UIMacros)**   
  UI macros are discrete scripted components administrators can add to the user interface.
* **[Jelly tags](https://www.servicenow.com/docs/LBQBK4D2Vdu~ZP7TyzTL8A)**   
  Use Jelly to turn XML into HTML.