BeyondERP.Newsletter
Menu

Setup step on the Button grids page · Retail and Commerce

Set up Button grids

Use this page to build and maintain the button grids used on the Welcome and Transaction screens, setting each button's action, parameters, text, size, colours and image.

Used by
Retail operations manager, Retail service, Information technology manager
Business process
Manage sales channels
Menu item
RetailButtonGrid
Main table
RetailButtonGrid
Data entity
RetailButtonGridEntity
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 create button grids (sets of buttons that invoke POS operations) and open the button grid designer to arrange buttons and set their properties.
What you do hereUse this page to build and maintain the button grids used on the Welcome and Transaction screens, setting each button's action, parameters, text, size, colours and image.
ExampleFor example, to expose an end-of-day custom operation you filter for a grid, open the designer, add a button, set its Action and run job 1090.
Button grids 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

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 Button grids

Use this page to build and maintain the button grids used on the Welcome and Transaction screens, setting each button's action, parameters, text, size, colours and image.

Steps from Microsoft

  1. Go to Retail and Commerce > Channel setup > POS setup > POS > Button grids.
  2. Select or filter for the button grid to change (for example F2W2).
  3. Select Designer and follow the instructions to install the designer; sign in if prompted.
  4. Right-click in the designer area and select Add new row, or select New button.
  5. Right-click the new button and select Button properties.
  6. Set the Action and other properties, select OK and close the designer.
  7. Go to Retail and Commerce > Retail and Commerce IT > Distribution schedule, select 1090 and select Run now.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
ActionThe POS operation the button invokes.Microsoft Learn
Action parametersExtra parameters some operations take, such as the product for Add product.Microsoft Learn
Button textThe text shown on the button.Microsoft Learn DisplayText
Hide button textHides the text for small icon-only buttons.Microsoft Learn HideButtonText
TooltipHelp text shown on mouse-over.Microsoft Learn Tooltip
Size in columns / Size in rowsHow wide and tall the button is.Microsoft Learn
Custom themeOverrides the visual profile accent colour with custom back and font colours.Microsoft Learn
Button imageAn image or icon from the Images page.Microsoft Learn

Test checklist

  1. Open the grid in the designer, add a button and set its Action and Action parameters.
  2. Set Button text, size and image; save.
  3. Run the 1090 job.
  4. In POS, check the button is visible, not overlapped, and runs the operation.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Button gridsReuse the same button grid across layouts and layout types where the operations are the same; keep separate grids only for different roles or languagesLearn says the same grid can be used across layouts and layout types. Button text is not translated, so separate grids are needed per language unless the multilanguage options are used.Overlapping buttons. Grid contents can overlap and hide each other, and the designer scales buttons, so check the grid on the real POS after job 1090.
Solution architect

5Design impact

Can it be undoneReversible: Grids can be redesigned at any time; changes reach POS after job 1090.
If you change it laterButtons can overlap and hide each other, the designer scales buttons so they may not match the POS exactly, and changes reach the POS only after job 1090 runs. Microsoft Learn
Technical architect

6Technical

Menu itemRetailButtonGrid Checked in Dynamics 365
FormRetailButtonGrid Checked in Dynamics 365
TableRetailButtonGridShown as “BUTTON GRID” in Record infoChecked in Dynamics 365
Data entitiesRetailButtonGridEntityPOS button grid Microsoft data model
Who can open itPrivilegesMaintain retail POS button grid RetailPOSButtonGridMaintainMaintain retail POS till layout RetailPOSTillLayoutMaintianDutiesMaintain 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
Actions on the page(Action Pane without tabs): Copy, DesignerChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailButtonGrid
Integrate withRetailButtonGridEntity data entity Microsoft data model
Data migrationRetailButtonGridEntity (POS button grid): shared by all companies.Microsoft Learn
Table definitionRetailButtonGrid columns and relations Microsoft data model
Everyone

8Sources

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