In Experience Builder, experiences are created in a private builder environment. When you save changes, the experience is saved in a draft status. These draft experiences are only visible to the author and others with administrative privileges in your organization. Publishing is the process that moves experiences from draft status to published status and enables the sharing of apps to a broader audience.
Use tools on the builder toolbar to experiment, refine, save, and preview the app to test the end-user experience before you publish and share it.
The toolbar at the top of the builder window includes the following options for testing and finalizing an app:
- Change the name of the experience item.
- Lock the layout to avoid unexpectedly changing a widget's size or position.
- Test interactive widgets in live view.
- View the app in multiple screen sizes to confirm or refine the layout.
- Undo or redo your last actions.
- Save changes, preview the app to test all saved configurations, and publish and share the web experience.
- Save the app as a new experience, change share settings, view and edit published item details, and copy the link for the published experience.
- Create an experience and generate a template.
- Scan QR codes to open the draft and published versions of the app. This is useful if you want to quickly view an app on a mobile device.
- Download .png files of the QR codes.
Once you publish and share an app, Experience Builder allows you to edit and test app updates without affecting the user experience in the live app. With the Draft, Published, and Unpublished changes statuses for web experiences, you can modify a published app, preview it, and test your changes, while users continue to access the live version. When you've made changes to a published experience, after clicking Save, an Unpublished changes badge appears on the builder's toolbar. To move the changes from the latest updates, publish the experience again.
If you attempt to preview or publish while there are unsaved edits, a warning appears prompting you to either cancel or save and proceed.
Printing and print preview
In a preview window, or while viewing a published app, you can review a print job before you send it to the printer by setting a link on a Button, Card, Image, or Text widget to Print preview. Print preview mode reorganizes special layouts such as screen groups and removes both animations and auto plays.
Widget versions
Experience Builder automatically updates with each release of ArcGIS Online. Releases typically include new versions of many Experience Builder widgets. In general, widgets in existing apps automatically update to the latest version if you are regularly opening the apps in the builder. However, some widgets may not update to the latest version.
Keep the following in mind regarding widget version updates:
- When you add a widget in the builder, the version recorded in the app's configuration file is the version at the time of addition.
- At run time, widgets dynamically update to the latest available version, but the new version is not saved in the app's configuration file.
- In the builder, a widget internally updates to the latest available version once you open it. You must save the app to update the widget's version in the configuration file.
To ensure that all widgets in an app are updated to the latest version after a release, open at least one of each type of widget in the builder. Opening a widget means switching to the page or view that contains the widget. If the widget is in a Widget Controller, open its panel. When you open a specific type of widget in the builder, all widgets of that type upgrade simultaneously. For example, opening one Map widget updates all Map widgets in an app.