Edit

Share via


Understand the cloud flows designer

You can create, configure, and customize your cloud flows with the classic designer or the cloud flows designer. For a description of the types of cloud flows, go to Overview of cloud flows.

Note

Here are some visual cues that tell you that you're using the new cloud flows designer (not the classic designer):

  • The cards in the flow are small.
  • The standalone action configuration pane appears on the left when you select a card.

More information: Identify differences between the classic designer and the new cloud flows designer

The following screenshot shows the features of the AI-powered cloud flows designer.

Screenshot of the cloud flows designer with Copilot.

Legend:

  1. Left arrow button: Return to the previous page.
  2. Undo and Redo buttons: Reverse or reinstate modifications you made to the flow.
  3. Send feedback button: Send us feedback about your flow creation experience or general comments about the AI-powered designer.
  4. Version history button: Track and manage changes made to your flows over time. It records every modification, enabling you to view previous versions, compare changes, and, if necessary, revert to an earlier version. Learn more in Drafts and versioning for cloud flows.
  5. Flow checker button: Check your flow for errors.
  6. Save draft button: Save a draft of your flow.
  7. Test button: Test your flow to make sure that it works as you intended.
  8. Publish button: Publish your flow so that your flow runs when the trigger event is performed.
  9. Copilot button: Show or hide the Copilot pane. The Copilot pane appears by default when the AI-powered designer opens.
  10. New designer toggle: Switch between the classic designer and the new cloud flows designer. Learn more in Identify differences between the classic designer and the new cloud flows designer.
  11. Action/trigger name: The action or trigger card that is selected in your flow in the center of the page (the canvas).
  12. More commands button: Add a note to the selected card, pin an action, or delete the card. There are two ways to pin an action. Learn more in View two action panes simultaneously.
  13. Collapse button: Hide the pane. When the pane is collapsed, the Expand button (>>) appears in the upper-left corner. Select it to show the pane again.
  14. Action configuration pane: After you select an action card to configure on the canvas, the action configuration pane opens on the left side of the AI-powered designer.
  15. Canvas: The canvas is where you build your flow. It's free-flowing and therefore allows for easier navigation.
  16. Copilot pane: Copilot stays with you during your flow editing and fit-and-finish journey. It can help you update and make changes to your flow, based on your conversational-style prompt. It can also help answer flow-related and product-related questions.

Undo and Redo

To reverse or reinstate modifications you made to the flow, you can use the Undo and Redo command bar buttons. For example, if you added or configured an action, or made significant adjustments to the flow, these features allow you to conveniently revert to a previous state or redo changes you previously canceled.

Screenshot of the 'Undo' and 'Redo' buttons in the command bar.

Send feedback

We want to hear from you to help us measure and improve our impact. To provide your feedback, select Send Feedback, answer the three questions in the feedback form that opens, and then select Submit.

Screenshot of the feedback form.

Save draft button

Select Save draft to save a draft of your flow. If there are no errors, the message, "Your flow is ready to go. We recommend you test it" appears in the upper left with a green check.

Screenshot of a successful save.

If an error is found, a description of the error and a red X appear in the upper left. The following screenshot shows an example of an error message.

Screenshot of an error message.

The error also appears on the card that caused the error in your flow. Correct the error, and then select Save again.

When there are no errors, your next step should be to test your flow.

Test button

After your flow is saved successfully, Test becomes active. To test your flow, select Test > After your flow is successfully saved, the Test button becomes available. To test your flow, select Test, select the Manually option, and then select Test.

Screenshot of the option for manually testing your flow.

Instructions appear and tell you what you must do to test your flow. The following screenshot shows an example of an instructional message.

Screenshot of instructions that tell you how to test your flow.

To test your flow, follow the instructions. In this example, you must send an email. The flow test then runs. When the test finishes running, a green check mark appears on each card, together with the number of seconds that it took to be processed.

Screenshot of test results.

Testing is part of the planning for a Power Automate project. To learn more, go to Introduction: Planning a Power Automate project.

More commands

Select the More commands () button to add a note to the selected card in your flow, pin an action, or to delete the card.

Select Add a note to describe the purpose of the card in your flow. After you add a note, a note symbol appears in the lower right of the card. To view the note, hover over this symbol.

Screenshot that shows a note being added.

Select Pin action to pin the action card to the top of the action configuration pane. This feature is useful when you want to compare two actions side by side, or copy values across two actions. Learn more in View two action panes simultaneously.

Action configuration pane

Use the action configuration pane to customize parameters, settings, and code for the selected card in your flow.

Parameters

On the Parameters tab, you can use the blue Insert token (lightning bolt) and Insert expression (fx) buttons next to the Inputs field to quickly enter values for the selected action card.

Screenshot of the Insert token and Insert expression buttons on the Parameters tab in the action configuration pane.

To insert a dynamic token into the Inputs field, select the Insert token (lightning bolt) button. In the pop-up window that opens, search for or scroll to find the tokens that you can use. After you select a token, it appears in the Inputs field.

To insert an expression into the Inputs field, select the Insert expression (fx) button. In the pop-up window that opens, select a function to start your expression. To complete your expression, place the cursor in the function, and then select Dynamic content. Search for or select the content/tokens to add, and then select Add. Your completed expression appears in the Inputs field.

To learn more about expressions, go to Reference guide to workflow expression functions.

Alternatively, use the keyboard to enter a slash (/) in the Inputs field. Then select the dynamic content/token and expression pop-ups.

Settings

On the Settings tab, you can set the action time-out, network retry policy, how an action should run, security input and output, and tracking properties. The following table provides a description of the settings.

Setting Description
General In the Action Timeout field, set the maximum duration between retries and asynchronous responses for the selected action. This setting doesn't change the request time-out of a single request.
Networking In the Retry Policy field, select a retry policy for intermittent failures. The default setting is an exponential interval policy that is set to retry four times. You can also set your own exponential or fixed interval settings, or choose none at all.
Run After In the Run After field, configure how an action should run after the execution of any of the preceding flow actions. For example, you can choose to run an action after the preceding action runs successfully, times out, skips, or fails.
Security Use the Secure inputs and Secure outputs toggles to turn the operations, and references of output properties, on or off.
Tracking Set the key and value of tracked properties.

Configurable trigger polling setting

In select triggers such as When an item is created-Sharepoint, and more, you can manually configure the trigger polling setting. This means you can configure how often the flow should check for new items in Sharepoint and others. This in turn ensures how quickly your flow responds to any changes or trigger events. The default polling period is three (3) minutes, which means the flow checks every three (3) minutes if a new item was created.

  1. On the action configuration pane, select the Parameters tab.

  2. Under the How often do you want to check for items? heading, enter the interval number and the frequency from the dropdown menu.

    Screenshot of the trigger polling setting in the action configuration pane, Parameters tab.

Code View

To view the code behind any card in your flow, select the card on the canvas, and then select Code View in the action configuration pane. As you customize the code on the Parameters tab, you can view the new code on the Code View tab.

The following screenshot shows an example of the code for the Compose action card.

Screenshot of the code view of the Compose action card.

Copy and paste actions

You can copy actions to the clipboard whether they're atomic actions or container actions. Examples of atomic actions are Compose, Get items, Create item, and others. Examples of container actions are Scope, Switch, Condition, Apply to each, and others.

To copy and paste an action, follow these steps.

  1. Right-click on any action (or trigger) you want to copy.

    Screenshot of copying an action.

  2. On the canvas, select + on the canvas to add an action, and then select Paste an action.

    You can copy and paste actions across different parts of your flow, or in between flows.

    Screenshot of pasting an action.

    After you paste your action, the copied action name is followed by -copy.

    Screenshot of an action that was copied and pasted, ending with a hyphen and the word 'copy'.

If you don't have access to a mouse, you can use your keyboard. To copy, press Ctrl + C. To paste, press Ctrl + V.

Canvas

For easy navigation, you can drag your flow on the canvas. You configure the actions of each card in the action configuration pane on the left. The cards on the canvas are compact to allow for easy visibility and navigation, especially in large flows.

Drop zones

The canvas contains AI-powered designer drop zones to help you easily drag cloud flow actions. Blue dashed lines represent the drop zones.

Screenshot of an action card and a drop-zone.

Zoom buttons

Depending on the size and complexity of your flow, you might want to adjust its size on the canvas as you're building it. Use the zoom buttons to zoom in, zoom out, fit to screen, and toggle a minimap. The buttons appear when the Action configuration pane is closed.

The bottom button is for the minimap. Use it to focus on a specific section of a large flow.

Screenshot of the four zoom buttons.

Expression editor and token picker

The expression editor in the designer is multi-line, which allows you to easily create and edit long, complex expressions. A gripper allows you to temporarily expand the box by one or two (1-2) lines, as needed. If that's not enough, you can expand the popup to a full page view. A search box allows you to search for tokens and functions, both in the Dynamic content view and Function view.

Screenshot of the expression editor.

Tip

You can use a forward slash ( / ) keyboard shortcut to invoke the token picker/expression editor popup when you're on an action field.

Create, update, and fix your expressions with Copilot expression assistant (preview)

[This article is prerelease documentation and is subject to change.]

This is a preview feature and is available to tenants where Copilot is enabled. On the modern designer, you can use this functionality to create, update, or fix expression with the help of Copilot.

Important

  • This is a preview feature.
  • Preview features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.

Scenario 1: Create expression with natural language

  1. On the expression editor, select Create expression with Copilot.

    The user experience that displays is the user experience for expression assistant.

  2. In the text box, write a prompt to generate an expression for, and select Create expression.

    You can reference the flow’s dynamic content in your prompt using their names to build expressions around. For example, assume you have first name, last name, phone number, and TriggerDate as dynamic data in your flow. You can ask following sample prompts:

    • Concatenate first name and last name.
    • Grab last four characters of Phone Number.
    • Convert Phone number from Integer to String.
    • Format TriggerDate to 'DD-MM' format.

    Screenshot of creating an expression with Copilot.

Scenario 2: Update an existing expression with natural language

If you have an existing expression that you created manually or through the expression assistant, you can select Create expression with Copilot in expression editor. Now it understands the context of the expression, and any prompt you write is used to modify the existing expression.

To finalize the update, do the following steps:

  1. To return the updated expression, select Create expression.
  2. To apply to expression editor, select OK.
  3. To apply to your flow, select Add.

For example, the first step is to select an expression.

Screenshot of an input parameter.

The next step is to select Create expression with Copilot. Then, describe how you want to update this existing expression and select Update.

Screenshot of an expression and string functions.

Finally, select OK to apply the Copilot generated expression.

Screenshot of a suggested expression.

Scenario 3: Fix invalid expression using a button

You can use the same experience to fix erroneous expressions. The following example shows an erroneous expression that has a missing parenthesis after 'Phone' [variables function opening parenthesis didn't close].

Screenshot of an erroneous expression.

At this point, when you select Create expression with Copilot, it automatically fixes the expression that is currently loaded in expression editor.

Screenshot of a suggested fix for an erroneous expression.

Disable an action or enable static results on an action

On the designer, if you want to disable an action rather than remove it entirely, go to the Testing tab of the action and enable static outputs by turning on the Enable Static Result toggle. When the flow runs, this essentially treats the action as successful, without actually running the action.

Similarly, if you want to see how your flow reacts if a certain action fails with a code or succeeds with a code, you can use the same capability of static outputs available on the action to mock the action execution to your needs.

When static outputs are disabled, the toggle label is Enable Static Result. When static outputs are enabled, the toggle label is Disable Static Result.

Screenshot of the 'Enable or Disable Static Result' toggle in the Testing tab.

View two action panes simultaneously

One the new designer, you can pin an action pane so that you can open a second action pane next to it. This can be useful to compare two similar actions, or copy values across two actions.

To pin an action, you can either right-click the action on the canvas and select Pin action. Alternatively, in the action pane, you can select Pin action in the More commands dropdown menu.

Screenshot of the 'Pin action' menu option.

Once you pin an action, any other action pane when selected is placed to the right of the pinned action pane.

Screenshot of a pinned action next to the open action pane.

Note

To unpin, you can either right-click on action on the canvas and select Unpin action, or select the Pin icon on the action pane.

Identify differences between the classic designer and the new cloud flows designer

To quickly identify which designer version you're using, ask yourself the following questions:

  • Are the action cards on the flow small or large?
  • Is the action configuration pane inline or in a separate pane?

The new cloud flows designer has smaller cards to facilitate easy navigation. It also has a standalone action configuration pane on the left.

Limitations and known issues

You might notice that some functionalities that were in the classic designer aren't available in the cloud flows designer yet. Currently, the designer doesn't support the following items:

  • Non-Open API flows (If there's Peek code on an action and if you see the API Connection value instead of OpenAPI Connection in Kind field, it's a non-Open API flow.)
  • Some hybrid triggers:
    • When a flow is run from business process flow (Dataverse)
    • Microsoft 365 Compliance Connector
  • A comment
  • Power Pages connector
  • Power Apps v1 trigger
  • Perform a changeset request action (Dataverse)
  • A solution flow using connections instead of connection reference isn't supported. We recommend that you use connection reference instead.

As we continue to innovate, we're introducing a new designer alongside our classic designer. While the classic designer remains valuable, the new designer is our future direction. While the classic designer isn't supported indefinitely, the new designer is gradually becoming the primary interface.

If you prefer to access features not yet available in the new designer, or encounter any limitations or known issues, you can temporarily revert to the classic designer. Simply turn off the New designer toggle on the menu in the cloud flows designer.

Screenshot of the 'New designer' toggle.

Note

The Power Automate cloud flows designer isn't yet available in integration surfaces such as Power Apps, Teams, and others.

FAQ

Why do I get this error "O.split(...).at is not a function" when signing in?

Power Automate designer doesn't support browsers that are more than two (2) years old. You could see the aforementioned or similar errors in the designer if your browser version is old. It's generally a good idea to update your browser to latest version to avoid such issues.

Why do I get this error "The provided flow name contains invalid characters" when importing a flow in a new tenant?

This error is a temporary gap, which you can work around by adding a query parameter v3=false in your URL.

Why don't I see new or updated SharePoint or Excel column values in my flow?

Power Automate designer requires a flow action to be re-added in order to pick up new entities of the underlying action. For example, if you have a SharePoint Get item action in your flow and Sharepoint item has four (4) columns, the flow allows you to access all four column values of the SharePoint item. Now, if you navigate to SharePoint, add a fifth column, and come back to the flow, you can't access the fifth column unless you delete the Get item action and re-add it again to force the designer to pick up the latest changes. The same behavior applies in Excel columns, Dataverse, OneDrive folder/files, and others.

Will the new cloud flows designer eventually replace the classic designer fully?

Yes, once the issues noted here are resolved and the new cloud flows designer can cover most, if not all, of the classic designer scenarios. At this time, the classic designer will be fully replaced.