Update report settings at runtime

You can use the report.updateSettings method to update the report settings when the report is already loaded. The settings property is used to adjust the appearance and behavior of your embedded Power BI report.

How to update the report settings

The Power BI Client Report class defines the updateSettings method as:

report.updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>

See Configure report settings for the settings object details.


To update the report settings and show the bookmarks pane:

const newSettings = {
    panes: {
        bookmarks: {
            visible: true

await report.updateSettings(newSettings);


The following settings can't be updated after the report is loaded:

  • Locale settings
  • Mobile layout, if the report was initially loaded or bootstrapped without mobile layout
  • Page navigation pane position

Next steps