Customize the command bar using command designer
This article guides you through creating and editing modern commands using the command designer and Power Fx.
Open the app designer
Create a new model-driven app using modern app designer
Sign into Power Apps .
On the left navigation pane, select Solutions. If the item isn’t in the left navigation pane, select …More and then select the item you want.
Open or create a solution to contain the new model-driven app.
Select New > App > Model-driven app.
Enter a Name for your app, and then select Create. More information: Create a model-driven app that has an account table page
Open an existing model-driven app using modern app designer
- Sign into Power Apps
- On the left navigation pane, select Solutions. If the item isn’t in the left navigation pane, select …More and then select the item you want.
- Open the solution containing the existing model-driven app.
- Select the model-driven app, and then select ... > Edit to open the modern app designer.
Create or edit modern commands
Once you are in the app designer, use the command designer to customize your command bars.
- Currently, the command designer can only be accessed through the modern app designer or within solutions for existing commands.
- Currently, classic commands can't be edited within the command designer.
Edit the command bar
Open the command designer to edit a command bar
Select any table from the Pages area in the app designer.
Select ..., and then select Edit command bar.
Select the location of the command bar you want, and then select Edit. More information: Command bar locations
Create a new command
Unlike classic commands, modern commands are only displayed within the app you're editing. This prevents unwanted command transferring to other apps as well as better runtime performance.
Open the command designer to edit a command bar, and then select + New Command.
On the right pane, enter or select from the following options:
Label (optional). Enter a label that will be displayed on the command button.
Icon. Select an icon for the command button. You may choose from any system icons or web resource SVG files. To upload your own icon, choose Web resource then upload an SVG format file. Then, select Save and Publish the web resource. For more information about how to create a web resource for the icon image you want, go to Create or edit model-driven app web resources to extend an app.
Action. Select from the following:
Visibility. Select whether to Show the command button or to Show on condition from formula.
Tooltip title (optional). Enter a tooltip title. The title appears to the user when they hover their mouse over the command.
Tooltip description (optional). Enter a tooltip description. The description appears for the user below the tooltip title when they hover their mouse over the command.
Accessibility text (optional). Enter the text that will be read by screen readers.
Order number. The order the command will display in at runtime in relation to other commands within the same command bar.
Drag and drop the command to the desired location. You can arrange modern commands amongst classic commands.
Select Save and Publish to make the command available to app users.
Select Play to run the app and test your changes
- Publishing Power Fx formulas can take a few minutes to publish the command component library. This background operation may still be in-progress after command designer has completed the request and unlocks the designer.
Use Power Fx for actions and visibility
You can use Power Fx for both actions (what happens when the command button is selected) as well as visibility (logic to control when the button is visible). Power Fx is not supported in classic commands.
You’ll notice the model-driven app command has a formula bar experience that is similar to canvas apps. For working with Dataverse data you can use Power Fx formulas just as you would in canvas apps. More information: Using Power Fx with commands
- Dataverse is currently the only data source supported with commands in model-driven apps.
- You can't currently add additional tables as data sources directly from the command designer. However, you may open the command component library in canvas studio and add additional tables as data sources and then use them within the command designer.
- Not all functions available within canvas apps are supported currently for model-driven app commands. Additionally, we've introduced some new functions specific to model-driven app commands.
- For more limitations with modern commands, see Modern commanding known limitations.
Select Add library or select another one from the list. The list is populated with any libraries in use by the current command bar.
Enter the Function name. For example, select the
Main_system_library.jslibrary then call this function:
Add parameters to pass to your function.