{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/v1.40/ui/environment/domain/create","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/ui/environment/domain/create","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/ui/environment/domain/create","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/ui/environment/domain/create","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/ui/environment/domain/create","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/ui/environment/domain/create","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/ui/environment/domain/create","default":false,"active":false,"folderId":"c15a2701"}],"sharedDataIds":{"sidebar":"sidebar-products/custody/@v1.15/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Create 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":"create-domains","__idx":0},"children":["Create domains"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you create new domains, you need to specify the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The users that belong to the domain and their role in the domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The governing strategy to apply."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Roles with read-only access permissions to view different entities in the domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The roles that can administer the default policy created with the domain."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All ","Ripple Custody"," environments include at least a root domain by default, so you can only create new domains that are a subdomain of the root domain or, if one exists, another subdomain."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-domain","__idx":1},"children":["Create a domain"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a domain:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain"]}," drop-down menu at the top left, select the parent domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domains"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a domain"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the domain details, as follows:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Page"},"children":["Page"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Details"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["General information"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["General details of the domain:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Name"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional information, including description and custom properties"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Governing strategy:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Coerce descendants"]},": Ignore policies in this domain's subdomains"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consider descendants"]},": Consider policies in this domain's subdomains."]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"If you do not choose a governing strategy, the default ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Consider descendants"]}," strategy applies.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.19/get-started/deployment/system-setup/setup#governing-strategy"},"children":["Learn more about the governing strategy"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User information"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One or more users associated with the domain:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Email address of an existing or new user."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User role within this domain."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Access management"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Role-based read-only access in the domain: ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["List of objects each user role can view in read-only mode"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User roles that can administer the default policy"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Summary"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Details entered for review and submission"]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$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.19/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 created when the domain creation intent is successfully approved and executed."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The domain is created along with a default, catch-all policy. You can update this and add other policies more suited to your requirements by following the instructions in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.19/ui/environment/policy/create"},"children":["Create policies"]},"."]}]},"headings":[{"value":"Create domains","id":"create-domains","depth":1},{"value":"Create a domain","id":"create-a-domain","depth":2}],"frontmatter":{"seo":{"title":"Create domains"}},"lastModified":"2025-11-04T22:51:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.19/ui/environment/domain/create","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}