# Dock Parameters Resetting between each page **URL:** \ **Category:** Ignition\ **Tags:** perspective\ **Created:** [July 10, 2023, 8:59pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160 "2023-07-10T20:59:01Z")\ **Posts on this page:** 9\ **Page:** 1
**Author:** ![Michael\_White](https://avatars.discourse-cdn.com/v4/letter/m/c6cbf5/32.png) [@Michael\_White](https://forum.inductiveautomation.com/u/Michael_White)\ **Post date:** [July 10, 2023, 8:59pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/1 "2023-07-10T20:59:01Z")
I have a dock configured like so ![2023-07-10 16_56_39-customer - sfdev - Ignition Designer](https://us1.discourse-cdn.com/inductiveautomation/original/3X/3/a/3a455e0af8cb94008a86f0114aefa5dea15656e7.png) In a couple places, I tried calling `system.perspective.alterDock('notif', {'content': 'cover'})`. It works, but whenever I navigate to another page, the dock config seems to reset to whatever was defined in the screenshot. (Aka the content setting gets changed back to `push` instead of `cover`) Can I make the dock state persist between pages? ---
**Author:** ![mazeyrat](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/mazeyrat/32/10955_2.png) [@mazeyrat](https://forum.inductiveautomation.com/u/mazeyrat)\ **Post date:** [July 10, 2023, 9:09pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/2 "2023-07-10T21:09:31Z")
Is it shared dock ? Be aware of alterdock limitation > [@\[IGN-6743\] system.perspective.alterDock can only resize one dock at a time?](https://forum.inductiveautomation.com/t/ign-6743-system-perspective-alterdock-can-only-resize-one-dock-at-a-time/65306): > > I recently started doing some testing to resize docks using the new system.perspective.alterDock function, and it seems that it can only be applied to one dock at a time when I tested it on 8.1.21. Is this expected behavior, or is there some way to get the size change to stick? The environment I'm testing in has left, top, and right docks, and I'd like to be able to specify sizes for all 3 at the same time depending on the situation. ---
**Author:** ![Michael\_White](https://avatars.discourse-cdn.com/v4/letter/m/c6cbf5/32.png) [@Michael\_White](https://forum.inductiveautomation.com/u/Michael_White)\ **Post date:** [July 11, 2023, 1:44pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/3 "2023-07-11T13:44:27Z")
- It's the only dock on the bottom (there's 1 onDemand one on the left and 1 persistent one on the top) - I only modify that dock, the other 2 are immutable An oddity I noticed when debugging it. I had a binding bound to `session.props.page.path` that ran a script to call `alterDock` to set it to either cover or push mode. When I navigate to a page, I can see the dock very briefly reset to default settings before getting altered by the alterDock call again. However, if I click the link of the page I'm already on, thus the binding for the path never runs, the dock gets reset anyway (but doesn't go back to its intended position because the binding never runs) ---
**Author:** ![cmallonee](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/cmallonee/32/6416_2.png) [@cmallonee](https://forum.inductiveautomation.com/u/cmallonee)\ **Post date:** [July 11, 2023, 2:18pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/4 "2023-07-11T14:18:15Z")
Known issues aside, AlterDock is only intended to work for the current page. As you move from page to page in your session, you are loading a new page configuration which will replace your existing Docked Views with whatever is configured for the Page config you have loaded. > [@Michael\_White](#): > > However, if I click the link of the page I'm already on Yep, because you're loading a new (albeit same) Page configuration, which is replacing the old one. Since the value in `page.path` has not changed, the script will not be run again. Note: `session.props.page.path` is not known to me - was this a miscommunication, or are you creating this property yourself and updating it somehow? ---
**Author:** ![Michael\_White](https://avatars.discourse-cdn.com/v4/letter/m/c6cbf5/32.png) [@Michael\_White](https://forum.inductiveautomation.com/u/Michael_White)\ **Post date:** [July 11, 2023, 2:30pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/5 "2023-07-11T14:30:38Z")
Sorry, it was just `page.props.path` on a component. Also clicking the same link does give the expected behavior (its reloading the config for the dock defined in the page, not continuing to use the altered config) ---
**Author:** ![aeliares](https://avatars.discourse-cdn.com/v4/letter/a/9fc29f/32.png) [@aeliares](https://forum.inductiveautomation.com/u/aeliares)\ **Post date:** [December 1, 2025, 5:52pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/6 "2025-12-01T17:52:28Z")
Hi everyone, this issue has been resolved and you will now be able to modify multiple docks using system.perspective.alterDock without the last changes being reverted in 8.3.3. ---
**Author:** ![Bushmatic](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/bushmatic/32/87014_2.png) [@Bushmatic](https://forum.inductiveautomation.com/u/Bushmatic)\ **Post date:** [March 25, 2026, 2:53pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/7 "2026-03-25T14:53:56Z")
What about having dock parameters/configurations persist when opening new pages with the same dock configuration? This thread is regarding that issue, not the topic of altering multiple docks at once. My issue is very similar to @Michael_White’s. I have a simple button to `show`/`autoHide` the dock (among other configuration changes, including content, modal, handle…) using `system.perspective.alterDock()`. Default is `autoHide`. When clicking a link in the docked view to navigate to a new page (but with the same dock configuration in the page configuration → shared settings), the dock configuration resets to the default defined in the shared settings. I also don’t see an easy to way to use parameters to accomplish this. It would be great to have a checkbox in my dock configuration to have its configuration persist between pages. Also, the documentation on [this page](https://www.docs.inductiveautomation.com/docs/8.1/appendix/scripting-functions/system-perspective/system-perspective-alterDock) is wrong, at least for the config → display parameter. The documentation states that the accepted parameters are `push`, `cover`, or `auto`, but in my logs, it is telling me the accepted parameters are `visible`, `onDemand`, or `auto`. Version 8.1.37. ![image](https://us1.discourse-cdn.com/inductiveautomation/original/3X/5/f/5f59b068b2539b902a502a7a4d37fef23a16fa7e.png) ---
**Author:** ![cmallonee](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/cmallonee/32/6416_2.png) [@cmallonee](https://forum.inductiveautomation.com/u/cmallonee)\ **Post date:** [March 25, 2026, 3:50pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/8 "2026-03-25T15:50:48Z")
> [@Bushmatic](#): > > the dock configuration resets The dock configuration is not “resetting”. You are opening a new page, which loads its own Docked View configuration. There is no session-wide docked view state registry, so when you open a new page, you get a new instance of docked views loaded up as they are configured in the Designer. This is primarily because Perspective is a single-page application. > [@Bushmatic](#): > > Also, the documentation on [this page](https://www.docs.inductiveautomation.com/docs/8.1/appendix/scripting-functions/system-perspective/system-perspective-alterDock) is wrong, I’ve reached out to the Docs team in order to get that corrected. ---
**Author:** ![Bushmatic](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/bushmatic/32/87014_2.png) [@Bushmatic](https://forum.inductiveautomation.com/u/Bushmatic)\ **Post date:** [March 25, 2026, 3:51pm UTC](https://forum.inductiveautomation.com/t/dock-parameters-resetting-between-each-page/76160/9 "2026-03-25T15:51:57Z")
Sounds good. Thanks for the response!