Publishing Configuration Changes
Last Modified: 2026-11-19

Publishing Configuration Changes

Resources, roles and scopes, policies, and identity-provider bindings are authored tenant-wide and associated with a gateway, but they only take effect on that runtime once they are published to it. Anything created or associated since the last publish is pending on that gateway. Changes are listed in Publish management first, so you can review what will change and on which gateway before the change takes effect.

Procedure 

  1. On the Gateways page, click View publishing in the banner that shows how many changes are waiting to be published, to go to the Publish management page.

  2. On the Pending changes tab, review the list of pending changes, which shows the Publish ID, Change, Object (for example, Gateway config, IdP configuration, Policies, Agents, Connected resources, or Roles and scopes), Target runtime, and when and by whom the change was Staged. Filter by Target runtime or Object type, or search the list.

  3. Click Publish on a change, or select several changes and click Publish in the bar at the bottom of the page.

Results 

A confirmation message and banner state that the change was published to the target runtime. The target gateway begins enforcing the new configuration.

To review what was published, open the Publish history tab. It lists each publish with its Result (Succeeded or Failed), Published at, Published by, Staged by, and, for a failed publish, an Error code. Filter by Target runtime, Object type, Result, or Date range, or click Export. If a publish fails, the runtime is unchanged; click Retry on the failed publish. The history then shows the failed publish as Retriedas a new publish ID, and the new publish as a Retry of the failed one.