Resolving TIA Portal V11 WinCC Menu & Toolbar Unexpected Error
The TIA Portal V11 SP2 engineering environment ships with a known defect that affects the WinCC Professional (and to a lesser degree WinCC Comfort/Advanced) runtime editor. When the user opens Menu & Toolbar configuration under an HMI device or global screen, the TIA Portal host process raises an unhandled exception, displays a generic "Unexpected error" dialog, and offers a "Restart application" prompt. After the restart, the same fault re-occurs the moment the editor is opened again, making it impossible to assign user-defined menus, function keys, or toolbars to the HMI project. This article documents the confirmed root cause, the two recovery paths confirmed by Siemens support, and the supporting diagnostics for distinguishing user-profile corruption from project-level corruption.
1. Problem Symptoms
The failure presents with a deterministic sequence of events. Engineers should confirm all of the following before applying the recovery procedure, because the same symptom can be produced by unrelated defects (e.g., a corrupted HMI project file or an .NET runtime mismatch):
- The user selects an HMI device (or opens the project library) in the TIA Portal project tree.
- The user right-clicks Menu & Toolbar under HMI tags / Screen management and chooses Edit, or opens the editor by double-clicking.
- The TIA Portal host (Siemens.Automation.Portal.exe) terminates with the modal dialog:
"An unexpected error has occurred. We are sorry for the inconvenience. Restart the application?" - After clicking Restart, the environment reloads, but the editor crashes identically the next time it is opened.
- The defect reproduces in every project on the workstation, including newly created ones with no user-added HMI screens.
Two related secondary symptoms are sometimes reported in the same environment:
- Missing menu entries when the HMI runtime editor is opened for the first time after installation.
- Slow first-launch of the Menu & Toolbar editor followed by an out-of-memory exception on x86 hosts with less than 4 GB RAM.
2. Affected Versions and Configuration
| Component | Confirmed Affected | Fixed In |
|---|---|---|
| STEP 7 / WinCC Professional V11 SP2 | Yes (without Update 5) | Update 5 and later |
| STEP 7 / WinCC Basic V11 SP2 | Yes (Menu & Toolbar limited; rare crash) | Update 5 and later |
| TIA Portal V11 SP2 (combined package) | Yes | Update 5 and later |
| TIA Portal V11 SP1 | Partial – editor unavailable | Migrate to SP2 + Update 5 |
| TIA Portal V12 (and later) | No – editor redesigned | N/A |
The defect is independent of the Windows version, but is most frequently observed on Windows 7 SP1 (32-bit and 64-bit) with .NET Framework 4.0/4.5. On Windows 8 and Windows Server 2008 R2 hosts, the same root cause produces a similar stack trace in the TIA Portal log.
3. Root Cause Analysis
Siemens has not published a detailed public RCA, but two distinct triggers are documented in the engineering support database and reproduced by field engineers:
-
Corrupt user-scoped settings file. The TIA Portal stores editor layouts, last-opened paths, and the Menu & Toolbar state for the HMI runtime editor in
Settings.xmlunder the per-user roaming profile. When this file becomes inconsistent with the host schema (typically after a partial Update installation, an aborted Windows shutdown, or a copy of a profile between machines), the editor fails to deserialize its configuration and throws the unhandled exception. -
Defect in V11 SP2 base build. Even with a clean
Settings.xml, the base SP2 build (without Update 5) can produce the same stack trace when the Menu & Toolbar editor instantiates a non-initializedIEditorContext. The fix ships in Update 5 for V11 SP2.
Because the two triggers are indistinguishable from the user interface, the recovery workflow attempts the lighter user-profile fix first, then escalates to the software hotfix.
4. The Settings.xml File – Location and Function
The TIA Portal V11 stores editor and view state information in a per-user XML file. The file is regenerated automatically on first launch if it is missing or invalid, but only if the host process does not crash on a partial read.
| Parameter | Value |
|---|---|
| File name | Settings.xml |
| Default path (Windows 7/8) | C:\Users\<user>\AppData\Roaming\Siemens\Automation\Portal V11\Settings\Settings.xml |
| Default path (Windows XP, legacy) | %USERPROFILE%\Application Data\Siemens\Automation\Portal V11\Settings\Settings.xml |
| Hidden attribute | File is not marked hidden by default |
| Default size | 4 – 32 KB depending on installed options |
| Owner | The interactive Windows user; file is not shared |
Backup the file before any manipulation. The path is the same for both the single-user installation and a parallel admin install: only the user profile component changes.
%APPDATA%\Siemens, the TIA Portal installer writes the initial Settings.xml on first launch. Subsequent updates (Update 5, etc.) may fail to merge if the directory is read-only. Verify that the user owns the Portal V11 subtree.5. Pre-Flight Diagnostics
Before touching the engineering workstation, perform the following checks to confirm the failure mode:
-
Inspect the TIA Portal log. Open
%LOCALAPPDATA%\Siemens\Automation\Portal V11\Logs(or the equivalent for older TIA Portal builds) and look forEditorHostExceptionwith the inner exceptionNullReferenceExceptionatSiemens.Hmi.Editor.Toolbar.ToolbarEditor.Load(). This signature is the Menu & Toolbar defect. - Test with a brand-new project. File > New project > PC station with WinCC Professional. If the crash reproduces with no custom HMI screens, the cause is environmental (user profile or installation), not project-level.
-
Test with a second Windows user. Create a local Windows account, log in once, and open the same TIA Portal project. A clean profile that does not crash confirms the corrupt
Settings.xmltheory. -
Confirm the build number. In TIA Portal: Help > About. The build should be reported in the form
V11.0 + SP2 + Update X. A value ofV11.0 + SP2without any Update suffix is the affected configuration.
If only the original user is affected and a second user is clean, the problem is isolated to Settings.xml and can be fixed without touching the installation.
6. Solution 1 – Reset the User Settings File
This is the lowest-impact fix and resolves the majority of field cases. It does not require administrator rights and does not modify the TIA Portal installation.
6.1 Step-by-Step Procedure
- Close all instances of TIA Portal, including the TIA Portal Help system and the Automation License Manager.
- Open Windows Explorer and navigate to:
C:\Users\<your_user>\AppData\Roaming\Siemens\Automation\Portal V11\Settings\
On Windows 7/8 you can paste the path directly into the address bar. TheAppDatafolder is hidden; enable Show hidden files in Explorer if necessary. - Copy
Settings.xmlto a backup location, for exampleD:\TIA_backup\Settings_<date>.xml. Keep this file – it may contain custom HMI symbol library paths you want to restore. - Delete the original
Settings.xmlfrom theSettingsfolder (or move it to a temporary folder outside theSiemenstree). - Start TIA Portal V11. On first launch the host recreates
Settings.xmlwith default values. - Open a project containing an HMI device and double-click Menu & Toolbar. The editor should now open without the restart prompt.
- If the editor still crashes, restore the backup
Settings.xmland proceed to Solution 2 – Update 5. The user-profile fix is not the cause in this case.
6.2 Verification
After the editor opens, perform a non-trivial test to confirm the fix is durable:
- Add a new menu entry, bind it to a script function, save the project, close the project, and reopen it.
- Export the HMI project to a USB drive and import it on a second workstation running the same TIA Portal build to verify portability of the new
Settings.xml.
7. Solution 2 – Apply TIA Portal V11 Update 5
If resetting the user settings does not resolve the crash, the cause is the base SP2 defect, and the only supported fix is the software hotfix V11 SP2 Update 5 (sometimes referred to as Hotfix 5 or HSP 1105). A clean reinstall is not required and is explicitly discouraged by Siemens support for this symptom.
7.1 Where to Obtain Update 5
Update 5 is delivered through the standard Siemens support channels:
- Siemens Industry Online Support – search for article ID W7XP10004886 or the keyword TIA Portal V11 SP2 Update 5.
- The Software Update Service (SUS) channel, for customers with a valid SUS contract covering the engineering license.
- The Siemens Support Request reply, which delivers a private download link to the customer who opened the SR (see Solution 3).
Updates are cumulative: installing Update 5 brings the build to V11.0 + SP2 + Update 5; Update 6 and Update 7 are incremental and may be installed on top of Update 5 without regression.
7.2 Prerequisites
- Local administrator rights.
- At least 6 GB free disk space on the system drive (the update temporarily extracts the patch payload).
- All TIA Portal instances closed, including the License Manager and the Help Viewer.
- The TIA Portal DVD or original media must be present in the installer cache, because the update verifies the base installation paths.
7.3 Step-by-Step Procedure
- Extract the Update 5 package to a local folder, e.g.
D:\TIA_V11_SP2_Update5. - Right-click
Start.exein the extracted folder and select Run as administrator. The TIA Portal Update Wizard launches. - Accept the license agreement and confirm the target installation directory.
- Wait for the wizard to complete the file replacement. The process typically takes 8 – 15 minutes on a typical workstation.
- Reboot when prompted. The reboot is required to release locked DLLs in
C:\Program Files\Siemens\Automation\Portal V11\Bin. - Start TIA Portal and verify the build string in Help > About now reads
V11.0 + SP2 + Update 5(or later). - Open the previously failing project and test the Menu & Toolbar editor.
7.4 Rollback Procedure
If Update 5 introduces an unrelated regression (rare, but documented in mixed C#-VBScript HMI projects), the update can be removed via Control Panel > Programs and Features > View installed updates. The base SP2 build is left untouched. Note that any projects saved with Update 5 cannot be opened on a pre-Update-5 workstation; preserve a pre-update project copy if backward compatibility is required.
8. Solution 3 – Open a Siemens Support Request
If both solutions above fail, the issue is most likely a project-specific defect (e.g., a corrupted HMI tag table or an embedded third-party ActiveX control that conflicts with the editor). The next step is a Siemens Support Request (SR) with the failing project attached.
- Open the Siemens Industry Online Support portal and log in with the customer account.
- Navigate to My Support > Support Requests > Create new request.
- Choose the product STEP 7 / WinCC Professional V11 and the support type Software > TIA Portal.
- Attach the project archive (use Project > Archive > Archive with simulated data in the TIA Portal), the
Settings.xmlfrom the affected user profile, and the contents of the%LOCALAPPDATA%\Siemens\Automation\Portal V11\Logsdirectory. - Describe the symptom, the build number, and confirm that the user-profile fix (Section 6) and the Update 5 fix (Section 7) have both been attempted.
- Submit the SR. Siemens typically responds with a workaround or a private hotfix within 2 – 5 business days, depending on the contract.
9. Distinguishing Project-Level vs Installation-Level Corruption
The Menu & Toolbar crash can also be triggered by a single corrupted object reference inside the HMI project tree. The following matrix helps separate the three primary causes:
| Symptom | Likely Cause | Recommended Action |
|---|---|---|
| Crash on every project, including a brand-new project | User profile or installation defect | Apply Solutions 1 and 2 |
| Crash on a single project; other projects open normally | Project-level corruption | Open a backup archive, or open the SR workflow (Solution 3) with the failing project |
Crash on a second Windows user only after copying the original Settings.xml into the new profile |
Profile carry-over | Do not copy Settings.xml between users; let TIA Portal regenerate it |
| Crash after applying a SUS update in the middle of an editing session | Partial update – file lock | Re-run the SUS update with a clean reboot before opening TIA Portal |
| Crash on Windows XP host with .NET 4.0 only | Incompatible Windows version | Upgrade to Windows 7 SP1 / Windows 10 and install .NET 4.5 or later |
10. Preventive Measures
- Install all V11 updates before commissioning a new HMI workstation. The Menu & Toolbar defect was the most common V11 SP2 hotfix trigger; Update 5 removes it permanently.
-
Avoid manual edits to
Settings.xml. The file is not intended to be edited by hand. Use the TIA Portal Options > Settings dialog to change the corresponding user options. -
Do not share
Settings.xmlbetween Windows users. Each user must generate their ownSettings.xmlon first launch. If a common configuration is required, distribute a project archive, not a user-profile file. -
Maintain a per-user backup of
Settings.xmlafter a working configuration is achieved. A simple scheduled task copying the file to a network share is sufficient and is a low-cost safety net against the same defect class in later TIA Portal versions. -
Apply Windows updates in a controlled window. Unattended Windows reboots during an active TIA Portal editing session can corrupt the file lock on
Settings.xmland trigger the same exception class on the next launch. - Keep the Automation License Manager updated. Older License Manager builds (V5.x) interfere with the Menu & Toolbar activation on hosts with the standard runtime license model.
11. Related Known Issues in TIA Portal V11 SP2
The Menu & Toolbar crash is one of several editor-level defects fixed in Update 5. Engineers working in the same environment should be aware of the following related symptoms, which Update 5 (and later updates) also address:
| Symptom | Hotfix |
|---|---|
| Library master copies open with empty content | Update 5 |
| HMI tag simulation stops responding after 15 minutes | Update 6 |
| WinCC Professional GraphQL-style "SmartClient" plugin fails to load | Update 5 |
| Cross-reference filter on S7-1500 tags returns stale results | Update 5 |
| HMI screen "Compile and download" reports phantom errors on the first attempt | Update 5 / 6 |
All of the above are bundled in the same Update 5 / Update 6 / Update 7 stream, so installing the latest available V11 SP2 update generally closes the entire defect class in a single maintenance window.
12. Verification Checklist
After applying the recovery procedure, run through the following checklist before signing off the workstation:
- TIA Portal opens without warnings on the affected user account.
- A new project is created successfully (PC station + HMI tag).
- Menu & Toolbar editor opens and the user can add, bind, and remove menu entries.
- A previously archived project opens with all menu entries intact.
- Help > About reports the expected build (V11.0 + SP2 + Update 5 or later).
-
The
Settings.xmlexists in the expected user-profile path. -
The TIA Portal log directory contains no new
EditorHostExceptionentries from the most recent test session. - A second Windows user account can open the same project and the Menu & Toolbar editor without the crash (proves the issue is not project-bound).
If all eight items pass, the workstation is considered recovered and the original change ticket can be closed.
13. Frequently Asked Questions
Does deleting Settings.xml lose my TIA Portal project data?
No. Settings.xml contains only per-user view state and editor layout, not the project itself. The TIA Portal project file (.ap11) and the HMI runtime files are stored elsewhere and are not affected. Always back up Settings.xml first in case you want to restore custom library paths.
Which TIA Portal V11 update first fixed the Menu & Toolbar crash?
Update 5 (HSP 1105) is the first update that resolves the Menu & Toolbar unexpected error in WinCC Professional V11 SP2. Updates 6 and 7 are cumulative and can be installed on top of Update 5.
Is a full TIA Portal V11 reinstall required to clear the fault?
No. Siemens support explicitly does not recommend a reinstall for this symptom. Reset the Settings.xml file in %APPDATA%\Siemens\Automation\Portal V11\Settings, and if the issue persists, install Update 5. Reinstalling the same SP2 image would not add the fix.
Can the same defect appear in TIA Portal V12, V13, or later versions?
No. The Menu & Toolbar editor was redesigned in TIA Portal V12 and the legacy SP2 defect class is no longer present. Upgrading to V13 / V14 / V15 / V16 is the long-term resolution for plants that want to avoid the V11 hotfix chain entirely.
What should I send to Siemens support if the project itself seems corrupt?
Archive the project via Project > Archive > Archive with simulated data, attach the Settings.xml file, and include the contents of %LOCALAPPDATA%\Siemens\Automation\Portal V11\Logs. Anonymize all tag names, alarm texts, and HMI passwords before sending. The Support Request portal is accessible at the Siemens Industry Online Support page.