Create a formatter and add it to a form
task brazil Updated Sep 10, 2026 2 min read t_CreateAFormatter.md
Create the formatter after creating the UI macro that defines the content.
Before you begin
Role required: ui_macro_admin
About this task
With the UI macro in place, create the formatter that references it, and add it to the form.
Procedure
-
Navigate to All > System UI > Formatters.
-
Click New.
-
In the Name field, enter a descriptive name for the formatter.
-
In the Formatter field, enter the name of the UI macro with
.xmlappended to it. -
In the Table field, select the table in which the formatter will be used.
-
In the Type field, select Formatter.
-
Click Submit.
-
To add the formatter to a form, configure the form design and add the formatter.
The formatter appears on the form according to your selections.
Parent Topic:Using formatters
Related topics
Create a UI macro for a formatter
65 lines · 1.7 KB
---
title: Create a formatter and add it to a form
description: Create the formatter after creating the UI macro that defines the content.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/platform-administration/t\_CreateAFormatter.html
release: brazil
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Formatters, Administer, Form administration, Forms, fields, and lists, Configure core features, Administer the ServiceNow AI Platform]
---
# Create a formatter and add it to a form
Create the formatter after creating the UI macro that defines the content.
## Before you begin
Role required: ui\_macro\_admin
## About this task
With the UI macro in place, create the formatter that references it, and add it to the form.
## Procedure
1. Navigate to **All** > **System UI** > **Formatters**.
2. Click **New**.
3. In the **Name** field, enter a descriptive name for the formatter.
4. In the **Formatter** field, enter the name of the UI macro with `.xml` appended to it.
5. In the **Table** field, select the table in which the formatter will be used.
6. In the **Type** field, select **Formatter**.
7. Click **Submit**.
8. To add the formatter to a form, configure the form design and add the formatter.
The formatter appears on the form according to your selections.
**Parent Topic:**[Using formatters](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-administration/c_Formatters.md)
**Related topics**
[Activity formatter]()
[Create a UI macro for a formatter]()
[Process flow formatter]()
[Parent breadcrumbs formatter]()
[Approval summarizer formatter]()
[Limit the number of activity stream entries]()
[Override a formatter with macros]()
| title | Create a formatter and add it to a form |
| description | Create the formatter after creating the UI macro that defines the content. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/platform-administration/t\_CreateAFormatter.html |
| release | brazil |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | FormattersAdministerForm administrationFormsfieldsand listsConfigure core featuresAdminister the ServiceNow AI Platform |