{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/v1.40/ui/environment/domain/update","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/ui/environment/domain/update","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/ui/environment/domain/update","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/ui/environment/domain/update","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/ui/environment/domain/update","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/ui/environment/domain/update","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/ui/environment/domain/update","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Update domains","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"update-domains","__idx":0},"children":["Update domains"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are different types of domain updates -- updates to the domain itself, and updates to the entities within the domain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"update-the-alias-and-description","__idx":1},"children":["Update the alias and description"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can only update the alias and description of a subdomain from the root domain."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To update the alias and description:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the root domain from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain"]}," drop-down menu."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domains"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the domain hierarchy, click the domain you want to update."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit information"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Name"]},", update the domain alias."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},", update the description."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submit for approval"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/ui/get-started/key-operations/intent-signature"},"children":["sign the operation with the app"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The domain is updated when the domain update intent is successfully approved and executed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"update-the-read-only-access-roles-of-a-domain","__idx":2},"children":["Update the read-only access roles of a domain"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To update the access management settings:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the domain or another domain above it in the same hierarchy from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain"]}," drop-down menu."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domains"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the domain hierarchy, click the domain for which you want to update access management."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit read permissions"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read permissions"]},", add or remove user roles."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the entities each user role can view."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submit for approval"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/ui/get-started/key-operations/intent-signature"},"children":["sign the operation with the app"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The domain is updated when the domain update intent is successfully approved and executed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"lock-or-unlock-a-domain","__idx":3},"children":["Lock or unlock a domain"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To lock or unlock a domain:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the domain or another domain above it in the same hierarchy from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain"]}," drop-down menu."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domains"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the domain hierarchy, click the domain you want to lock or unlock."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Depending on the current state, perform one of the following:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the domain is unlocked, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lock"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the domain is locked, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unlock"]},"."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/ui/get-started/key-operations/intent-signature"},"children":["Sign the operation with the app"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The domain is unlocked when the domain unlock intent is successfully approved and executed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-or-update-entities-in-a-domain","__idx":4},"children":["Add or update entities in a domain"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To add new entities to a domain:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the domain to which to add a new entity from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain"]}," drop-down menu."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Follow the relevant entity creation or update process, for example, ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.26/ui/environment/user/create"},"children":["Create users"]},"."]}]}]},"headings":[{"value":"Update domains","id":"update-domains","depth":1},{"value":"Update the alias and description","id":"update-the-alias-and-description","depth":2},{"value":"Update the read-only access roles of a domain","id":"update-the-read-only-access-roles-of-a-domain","depth":2},{"value":"Lock or unlock a domain","id":"lock-or-unlock-a-domain","depth":2},{"value":"Add or update entities in a domain","id":"add-or-update-entities-in-a-domain","depth":2}],"frontmatter":{"seo":{"title":"Update domains"}},"lastModified":"2025-11-04T23:32:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.26/ui/environment/domain/update","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}