BeyondERP.Newsletter
Menu

Setup step on the Custom fields page · Retail and Commerce

Set up Custom fields

Use this page to register a custom field, link its caption to a Language text entry, and make it available in the receipt designer or the screen layout designer; the logic that fills the field is written in CRT or POS extensions.

Used by
Retail operations manager, Retail service, Information technology manager
Business process
Manage sales channels
Menu item
RetailTerminalCustomField
Main table
RetailTerminalCustomField
Data entity
RetailTerminalCustomFieldEntity
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you define custom fields (name, type such as Receipt or Totals area, and caption text ID) that extend receipts or the POS Totals panel beyond the fields provided out of the box.
What you do hereUse this page to register a custom field, link its caption to a Language text entry, and make it available in the receipt designer or the screen layout designer; the logic that fills the field is written in CRT or POS extensions.
ExampleFor example, Fabrikam adds WARRANTYID and EXPIRATIONDATE receipt fields so that sales receipts can print warranty details.
Custom fields page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processDevelop sales policies › Manage sales channels
Menu pathRetail and Commerce › Channel setup › POS setup › POS profiles › Custom fields
Set up firstLanguage text Microsoft Learn
Used next byReceipt formats Microsoft Learn Screen layouts Microsoft Learn
Related pagesDistribution schedule Microsoft Learn
In this process Set up Visual profiles · Set up Language text
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Set up Custom fields

Use this page to register a custom field, link its caption to a Language text entry, and make it available in the receipt designer or the screen layout designer; the logic that fills the field is written in CRT or POS extensions.

Steps from Microsoft

  1. Go to Retail and Commerce > Channel setup > POS setup > POS profiles > Custom fields.
  2. On the Action Pane, select New.
  3. In the Name field, enter the name of the custom field.
  4. In the Type field, select Receipt or Totals area.
  5. In the Caption text ID field, specify the text ID created on the Language text page.
  6. On the Action Pane, select Save.
  7. Place the field in the receipt format designer or the screen layout designer, then run job 1070 (receipts) or 1090 (screen layouts).

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
NameThe name of the custom field; must match the fieldName used in the POS extension manifest.Microsoft Learn Name
TypeWhere the field is used: Receipt or Totals area.Microsoft Learn Type
Caption text IDThe Language text ID that supplies the localised caption.Microsoft Learn CaptionTextId

Test checklist

  1. Add Language text for en-US with Text ID 1.
  2. Create a custom field with Type Totals area and Caption text ID 1.
  3. Drag it into the Totals panel in the screen layout designer and run the distribution jobs.
  4. Check the caption shows in the POS Totals panel with the value from the extension.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Custom fieldsCreate the caption on Language text first, then the custom field with Type Totals area or Receipt and that Caption text IDThe custom field's caption comes from a Language text entry, which also lets you give the caption in several languages.Entering a Caption text ID that has no Language text entry, so the field has no label in POS.
Solution architect

5Design impact

Can it be undoneReversible: Fields can be edited; the value logic lives in the CRT or POS extension.
If you change it laterCustom fields belong to one legal entity, so the designer only shows the fields of the company set on the signed-in user. Microsoft Learn
Technical architect

6Technical

Menu itemRetailTerminalCustomField Checked in Dynamics 365
FormRetailTerminalCustomField Checked in Dynamics 365
TableRetailTerminalCustomFieldShown as “RETAIL REGISTER CUSTOM FIELD” in Record infoChecked in Dynamics 365
Data entitiesRetailTerminalCustomFieldEntityRetail register custom field Microsoft data model
Who can open itPrivilegesMaintain retail POS custom fields RetailPOSCustomFieldsMaintainDutiesMaintain retail register reference data RetailTerminalReferenceDataMaintain
3 security rolesRetail operations manager RetailOperationsManagerRetail service RetailServiceInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail service RetailServiceRetail operations manager RetailOperationsManagerInformation technology manager SysServerITManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailTerminalCustomField
Integrate withRetailTerminalCustomFieldEntity data entity Microsoft data model
Data migrationRetailTerminalCustomFieldEntity (Retail register custom field): shared by all companies.Microsoft Learn
Table definitionRetailTerminalCustomField columns and relations Microsoft data model
Everyone

8Sources

To cite this step: RC-POS-170, Set up Custom fields. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/RC-POS-170