To see general settings for an Experience Builder app or template, click General to open the Experience settings or Template settings panel.
Item settings
You can use the following settings to add information and images that communicate your app or template's branding and purpose:
- Favicon—Change the app or template's favicon. The favicon is an icon that identifies your app or template's web page. It appears in browser tabs, browser history, bookmarks bars and drop-down menus, and search recommendations. You can pick from the default icons or upload your own icons.
Note:
Safari does not display Experience Builder favicons.
- Thumbnail—Change the app or template's thumbnail. The thumbnail is usually a preview of the app or template's content. It appears on the item details page, on the Content tab when you view items in a list or grid, and in either the template gallery or the experience gallery that opens when you launch Experience Builder. You can upload an image file from your device. The recommended image size is 240 pixels wide by 160 pixels high.
- Summary—Provide a short description of the app or template. Like the thumbnail, the summary appears on the item page and on the Content tab when you view items in a list or grid. The summary can be up to 2,048 characters. To include more in-depth information, you can write in the description on the app or template's item page.
Time zone settings
Choose how Experience Builder handles time-based data from different time zones. These settings are relevant if your app or template uses feature layers with date fields.
Since different feature layers might contain data recorded with different time zones, and the physical locations of both the servers hosting the data and the people viewing the app can be anywhere in the world, you have options for how to display time fields.
Choose one of the following options:
- Select Device time zone to have Experience Builder ask the user's computer for its time zone settings and display all time data using that time zone. This option is appropriate if you want users across the world to see times in their own time zone.
- Select Specific time zone to choose a time zone from the drop-down menu and display all time data using that time zone. This option is appropriate if you want users to see all data in one specific time zone, no matter where in the world they access your app.
- Select Data time zone to display dates and times based on, for layers, the time zone property or, for web maps, the time zone settings defined in Map Viewer. Experience Builder makes no adjustments to the display of date information.
Note:
To use the Timeline widget, date and time data must be synchronized to one time zone, so the Timeline widget is only available if you choose Device time zone or Specific time zone.
Note:
For web scenes added to a Map widget, time zone settings do not affect date or time fields in pop-ups.
State and URL parameters
Click State & URL parameters to open the State & URL parameters panel. Here, you can allow users to restore a recently closed experience to its previous state, and you can control which URL parameters appear in the app URL at run time.
Experience state
Experience Builder stores information about the current app state in the browser cache. App state information includes which page, view, or window is currently open, the map viewpoint, and layer visibility. You can use the Experience state setting to restore the app interface to its previous state when you reopen the app.
If you turn on the toggle switch, the Restore experience state banner appears when you launch the app after having closed it before. The banner prompts you to restore the app to its previous state. It disappears automatically after 10 seconds.
The banner appears if there is any saved state information in the browser cache. If you clear your cache, the banner does not appear.
Note:
This setting does not restore layers and graphics added at run time with widgets such as the Add Data widget and Draw widget.
Manage URL parameters
Here, you can view the Data selection parameter and a list of any Map and Search widgets. If your app contains many Map and Search widgets, this list might be long, so you can use the search to bring up specific widgets.
Turn on the toggle button next to Data selection or next to each widget to include its associated URL parameter in the URL at run time. If you turn on Data selection, the Zoom to selected features check box appears. Check the box to also include the zoom_to_selection=true parameter in the URL when the user selects a feature. The Map widget has multiple associated URL parameters. For Map widgets, you can click the settings button to turn on individual parameters.
Turning a parameter off does not remove its function; it just means that the parameter does not appear in the URL. Having parameters in the URL is useful for sharing your app in an exact state. For example, you can generate a URL that opens your app to an exact map scale, rotation, and center point with a certain feature selected.
Privacy and security
Click Privacy and security to open the Privacy and security panel. Here, you can configure settings that control how the app handles user data and settings related to sign in and credentials.
Privacy
Turn on the toggle button next to Google Analytics (GA4) to have your app track data with Google Analytics. To connect your app to Analytics, enter a measurement ID in the text box that appears. The measurement ID is a unique identifier for a website or app. The format of a measurement ID is 'G-' followed by a combination of 10 numbers and letters. You get a measurement ID by adding a new data stream in Google Analytics.
Learn more about setting up Google Analytics for an app
Turn on the toggle button next to Cookie Banner to add a banner that asks the user for their consent to allow cookies. Cookies are small files that a server sends to a user's web browser. Experience Builder uses the following types of cookies:
- Essential cookies—These cookies are essential for basic website functions, such as keeping the user logged in. These are always used.
- Performance cookies—These cookies collect information related to how users interact with the app. They help optimize the user experience. When you ask the user for their consent to allow cookies, these are the cookies you are asking about.
The Privacy and security panel includes the following cookie banner settings:
- The Consent mode setting appears if you also turn on Google Analytics (GA4). You can make giving consent to allow cookies required or optional to use the app.
- Check the Refresh consent periodically check box to make the banner reappear for users who previously consented and ask them to give them their consent again. You must enter a number of days for the renew period.
- You can click Renew now to make the banner reappear for all users immediately. A warning appears to ask if you are sure you want to ask everyone to give their consent again. Click OK to confirm.
When you turn on the cookie banner, a settings panel appears on the right of the builder. You can configure the following style settings for the banner:
- Layout—Choose to have the interaction buttons appear at the bottom or on the right side of the banner.
- Position & Size—Define where the banner appears on the page by width, height, and location. You can specify height and width values in pixels (px) or percent (%). You can use the nine-panel grid to position the widget relative to one of the anchor points on the page. You can also set x and y offsets.
- Banner button settings—Choose which interaction buttons to include in the banner at run time.
- If you turn on Google Analytics (GA4), the Accept All button is included, and optionally you can include the Decline All and Preferences buttons.
- If you turn off Google Analytics (GA4), the Close button is included.
- You can expand each button to configure additional settings. You can replace the default button text and set an icon.
- Animation—Add an animation for when the cookie banner appears.
- Background—Choose a fill color or image for the banner background. Use the Quick style button to select from preset designs that coordinate with the app's theme.
- Border—Choose the color, style, and width for the banner border. You can change the radius size to shape the banner corners. Use the Quick style button to select from preset designs that coordinate with the app's theme.
- Box shadow—Add a shadow effect around the banner. Use the Quick style button to select from preset designs, or use the following settings:
- Offset X—Set the horizontal distance of the shadow. A negative value places the shadow to the left of the banner; a positive value places it to the right.
- Offset Y—Set the vertical distance of the shadow. A negative value places the shadow above the banner; a positive value places it below.
- Blur radius—Apply a blur effect to the shadow.
- Spread radius—Adjust the size of the shadow.
- Color—Select a color.
If you turn on Google Analytics (GA4) and turn off Cookie Banner, the app tracks web activity without notifying the user or asking for their consent. If you turn on both settings, the app only tracks web activity when the user gives their consent to allow performance cookies.
On the canvas, you can click the text box in the cookie banner to edit the banner text. If you highlight text, a toolbar appears that you can use to change the text font, size, color, and stroke. You can also set a link on text.
Note:
When typing in the text editor, use keyboard shortcuts to undo (Ctrl+Z for Windows; Cmd+Z for Mac) or redo (Ctrl+Y for Windows; Cmd+Y for Mac) text edits. The Undo and Redo buttons on the builder toolbar affect actions performed in the builder, such as connecting data or adding a widget, not text edits.
Security
Specific parts of an Experience Builder app may prompt users to sign in with an ArcGIS account. Even if the app itself is shared publicly, individual maps or layers might be private. Some widgets and utility services require an account with privileges, which are only available to organization members assigned with certain user types.
You can turn off sign-in prompts with the following settings:
- Skip sign-in prompt for secured resources—If you turn on this toggle button, users are not prompted to sign in to view unshared resources. Instead, the app only loads content that is accessible to the current user. Users can still sign in with the credential banner, if it is available.
- Skip credential banner—If an app includes widgets, data, utility services, or other components that require an account with certain privileges, a banner appears when the user accesses the app without the required credentials. The credential banner lists all the parts of the app that the user cannot access and prompts them to sign in with another account or ignore and continue without access to those things. If you turn on this toggle button, the credential banner does not appear.