Skip to content

Commit 8ad97d2

Browse files
committed
Merge remote-tracking branch 'origin/main' into adrianorth-patch-3
2 parents 5c69d98 + 1c2edc0 commit 8ad97d2

File tree

8 files changed

+48
-35
lines changed

8 files changed

+48
-35
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading

powerapps-docs/maker/canvas-apps/save-publish-app.md

Lines changed: 48 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: amchern
55
ms.topic: conceptual
66
ms.custom: canvas
77
ms.reviewer: mkaur
8-
ms.date: 02/09/2022
8+
ms.date: 2/15/2024
99
ms.subservice: canvas-maker
1010
ms.author: emcoope
1111
search.audienceType:
@@ -17,34 +17,43 @@ contributors:
1717
ms.collection:
1818
- bap-ai-copilot
1919
---
20+
2021
# Save and publish canvas apps
2122

2223
Whenever you save changes to a canvas app, you automatically publish them only for yourself and anyone else who has permissions to edit the app. When you finish making changes, you must explicitly publish them to make them available to everyone with whom the app is shared.
2324

24-
For information about how to share an app, see [Share an app](share-app.md).
25+
For information about how to share an app, see [Share an app](share-app.md)
26+
27+
## Save your app
28+
29+
With your app open for editing in [Power Apps](https://make.powerapps.com), you can save in several ways:
2530

26-
With your app open for editing in [Power Apps Studio](https://create.powerapps.com), in the app actions menu, select **Save** and perform the following actions:
31+
- Select **Save** :::image type="icon" source="media/save-publish-app/save-icon.png"::: to save any unsaved changes you made to your app. With each Save, a new version is created in App version history.
2732

28-
- **Save**: Saves recent and unsaved changes you made to the app in Power Apps Studio. Each time you save changes, a new version is created.
29-
- **Save with version notes**: Save and add notes about the updates you've made.
30-
- **Save as**: Duplicate the app by saving the app with a different name.
31-
- **Save and publish**: Allows you to save the app and publish it at the same time.
32-
- **Download a copy**: Downland a local copy of the app.
33+
- Or, in the dropdown menu, choose one of the following options:
3334

35+
- **Save with version notes**: Save and add notes about your updates.
36+
- **Save as**: Duplicate the app with a different name.
37+
- **Download a copy**: Download a local copy of the app.
3438

35-
> [!div class="mx-imgBorder"]
36-
> ![Studio save options.](media/studio/pa-studio-save-options.png)
39+
## Switch AutoSave on or off
3740

41+
You can also set Power Apps to automatically save every two minutes.
3842

39-
Power Apps can also periodically save the app every 2 minutes. If you've saved the app once, Power Apps will continue to save a version of the app periodically without requiring the user to press or tap the Save action. Authors can enable or disable the **Auto save** by going to **Setting** > **General**.
43+
1. Select **More** **...** > **Settings**.
4044

41-
![Auto save setting.](./media/save-publish-app/autosave.png)
45+
:::image type="content" source="media/save-publish-app/autosave.png" alt-text="Screenshot that shows where the ellipses points are located that opens a dropdown menu to reveal the Settings option.":::
4246

47+
1. Select the **General** tab.
4348

44-
> [!NOTE]
45-
> - Whenever you publish a canvas app, your app will be upgraded to run on the latest version of Power Apps – which means it will get the benefit of all the latest features and performance upgrades we’ve added since you last published. If you haven’t published an update in several months, you’ll likely see an immediate performance benefit from republishing now.
46-
> - To allow users to retrieve app details faster on app startup, certain data will be locally stored on users' devices in the browser cache. Information that will be stored includes app, environment, and connection details. This data will stay stored in the browser based on each browsers’ storage limits. Users can clear stored data based on [instructions for each browser](/troubleshoot/power-platform/power-apps/troubleshooting-startup-issues)
49+
1. In the **Auto save** section, set the **Auto save** toggle to **On** or **Off**.
4750

51+
:::image type="content" source="media/save-publish-app/autosave2.png" alt-text="Screenshot that shows where the Auto save toggle is located.":::
52+
53+
> [!NOTE]
54+
>
55+
> - When you publish a canvas app, your app is updated and runs on the latest version of Power Apps. Your app gets the benefit of all the latest features and performance upgrades added since you last published. If you haven’t published an update in several months, you might see an immediate performance benefit when you republish the app.
56+
> - To retrieve app details faster during startup, some data is stored locally on user devices in the browser cache. Information stored includes app environment and connection details. This data stays stored in the browser based on browser storage limits. Users can clear stored data based on these [instructions for each browser](/troubleshoot/power-platform/power-apps/troubleshooting-startup-issues#clear-your-browser-cache).
4857
4958
## Create an app description with Copilot (preview)
5059

@@ -57,54 +66,58 @@ You can also generate an app description by going to, **Settings** > **General**
5766
Admins can disable this feature for Managed Environments in the Power Platform admin. For more information, see [Managed Environments panel](/power-platform/admin/managed-environment-enable).
5867

5968
> [!NOTE]
60-
> If a description is not added before the app is published, Copilot will help generate one for the app once the app is published. Makers can always go back and edit this description if Copilot didn't quite get it right.
61-
69+
> If a description is not added before the app is published, Copilot generates one for the app once the app is published. Makers can always go back and edit this description if Copilot didn't quite get it right.
6270
6371
> [!IMPORTANT]
72+
>
6473
> - To use this capability your app must be in a [managed environment](/power-platform/admin/managed-environment-overview).
65-
> - 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.
74+
> - Preview features aren’t meant for production use and might have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
6675
> - For more information, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520).
67-
> - This capability is powered by [ Azure OpenAI Service](/azure/cognitive-services/openai/overview).
68-
> - This capability is in process of rolling out, and may not be available in your region yet.
69-
> - This capability may be subject to usage limits or capacity throttling.
76+
> - This capability is powered by [Azure OpenAI Service](/azure/cognitive-services/openai/overview).
77+
> - This capability might not be available in your region yet or be subject to usage limits or capacity throttling.
7078
> - To understand capabilities and limitations of AI-powered and Copilot features in Power Apps, see [Responsible AI FAQs for Power Apps](../common/responsible-ai-overview.md)
7179
72-
73-
7480
## Identify the live version
7581

76-
To see all versions of an app, go to [Power Apps](https://make.powerapps.com?utm_source=padocs&utm_medium=linkinadoc&utm_campaign=referralsfromdoc) > **Apps** > select your app > **Details** > **Versions**.
82+
To see all versions of an app:
83+
84+
1. Go to [Power Apps](https://make.powerapps.com?utm_source=padocs&utm_medium=linkinadoc&utm_campaign=referralsfromdoc) > **Apps**.
85+
1. Select the :::image type="icon" source="media/save-publish-app/vertical-ellipses.png"::: next to an app name.
86+
1. Select **Details**, then the **Versions** tab.
7787

7888
The **Live** version is published for everyone with whom the app is shared. The most recent version of any app is available only to those users who have edit permissions for it.
7989

80-
![Publish from portal.](./media/save-publish-app/publish-portal.png)
90+
:::image type="content" source="media/save-publish-app/publish-portal.png" alt-text="Screenshot that shows where different versions of the app are located and how to publish a specific version." lightbox="media/save-publish-app/publish-portal.png":::
8191

82-
To publish the most recent version, highlight the version and select ellipsis (...). Then select **Publish this version** from the drop-down menu.
92+
To publish the most recent version, select the publish icon :::image type="icon" source="media/save-publish-app/publish-icon.png"::: while in editing mode for your app.
8393

8494
> [!NOTE]
85-
> - Changes from a newly published version of an app may take a few seconds to reflect when launching the app. Publish time depends on the complexity of apps, so expect more complex apps to take a few more minutes to publish.
95+
>
96+
> - New published changes of an app might take a few seconds to display when launching the app. Publish time depends on the complexity of apps, which might take a few more minutes to publish.
8697
> - If you already have an app open while a new version is published, you must reload the app to get the latest changes.
87-
> - To reduce the time users wait to access your app, the app preload capability is turned on. You can chose to turn it off. Learn more [here](performance-tips.md#enable-preload-app-for-enhanced-performance).
98+
> - To reduce wait time to access your app, the app preload capability is turned on. You can turn it off. For more information, see [Overview of creating performant apps](create-performant-apps-overview.md).
8899
89100
## In-app notifications for an updated version of the app
90101

91-
Depending on the complexity of an app, changes that are recently published may not be available when a user launches the app. If this happens, users will get a toast notification stating **A new version of this app is coming. We'll let you know when it's available.** When the published changes are ready, users will see a notification stating **You're using an old version of this app. Refresh to use the latest version**. Users can select the **Refresh** button to see the latest version of the app.
102+
If users are waiting for an app to update, they get a notification stating **A new version of this app is coming. We'll let you know when it's available.**
103+
104+
When the published changes are ready, users see a notification stating **You're using an old version of this app. Refresh to use the latest version.**. Users can select the **Refresh** button to see the latest version of the app.
92105

93-
The following table shows the scenarios where this notification is available.
106+
### Notification availability
94107

95108
| Scenario | Availability |
96109
| - | - |
97110
| Canvas app on web | Generally available |
98111
| Customized SharePoint Forms | Not available |
99-
| Canvas app embedded in Teams | Not available |
100-
| Canvas app embedded in PowerBI | Not available |
112+
| Canvas app embedded in Teams | Not available |
113+
| Canvas app embedded in Power BI | Not available |
101114
| Power Apps web part | Not available |
102115
| Canvas app embedded in iframe | Generally available |
103116

104117
## Next steps
105118

106-
* Find and run the app in a [browser](../../user/run-app-browser.md) or on a [phone](../../mobile/run-powerapps-on-mobile.md).
107-
* [Rename an app](set-name-tile.md) from [Power Apps](https://make.powerapps.com?utm_source=padocs&utm_medium=linkinadoc&utm_campaign=referralsfromdoc).
108-
* [Restore an app](restore-an-app.md) if you have multiple versions of an app.
119+
- Find and run the app in a [browser](../../user/run-app-browser.md) or on a [phone](../../mobile/run-powerapps-on-mobile.md).
120+
- [Rename an app](set-name-tile.md) from [Power Apps](https://make.powerapps.com?utm_source=padocs&utm_medium=linkinadoc&utm_campaign=referralsfromdoc).
121+
- [Restore an app](restore-an-app.md) if you have multiple versions of an app.
109122

110123
[!INCLUDE[footer-include](../../includes/footer-banner.md)]

0 commit comments

Comments
 (0)