Troubleshooting¶
The UmbraScript section is missing¶
- Confirm that the package is referenced by the Umbraco project.
- Rebuild and restart the website.
- Confirm that the user's group has access to the UmbraScript section under Users and User Groups.
- Sign out and back in after changing group access.
A path does not resolve¶
For content:
- Begin the route with
/. - Use
atfor a single-item path reference. - Confirm the route in the website's default culture.
For media:
- Follow media item names from the media root.
- Ensure each path segment has a unique matching sibling.
- Use the media key if a name is ambiguous.
See References and selections.
A key is rejected¶
A bare quoted reference must be a GUID:
A path without at is interpreted as a key and produces US3001.
A command selected too many items¶
Rename, move, copy, trash, and restore commands operate on one item. Use a key or at "<path>", not in or below.
A property update failed¶
Check the per-item result:
propertyExistsindicates whether the content type contains the alias.oldValueandnewValueshow the attempted change.outcomecontains the Umbraco operation result.
Confirm that the property editor accepts a string in the supplied format. Variant properties require additional care because UmbraScript 1.0 does not select a culture or segment.
A batch only partially succeeded¶
Compare attempted, succeeded, and failed, then inspect every per-item outcome. Do not assume that successful earlier changes were rolled back. Resolve the individual failures and retry only the items that still require the operation.