{"templateId":"markdown","versions":[{"version":"v1.40","label":"v1.40 STS","link":"/products/custody/v1.40/ui/environment/policy/create","default":true,"active":false,"folderId":"c15a2701"},{"version":"v1.39","label":"v1.39 STS","link":"/products/custody/v1.39/ui/environment/policy/create","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.38","label":"v1.38 STS","link":"/products/custody/v1.38/ui/environment/policy/create","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.34","label":"v1.34 LTS","link":"/products/custody/v1.34/ui/environment/policy/create","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.26","label":"v1.26 LTS","link":"/products/custody/v1.26/ui/environment/policy/create","default":false,"active":false,"folderId":"c15a2701"},{"version":"v1.19","label":"v1.19 LTS","link":"/products/custody/v1.19/ui/environment/policy/create","default":false,"active":true,"folderId":"c15a2701"},{"version":"v1.15","label":"v1.15 LTS","link":"/products/custody/v1.15/ui/environment/policy/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 policies","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-policies","__idx":0},"children":["Create policies"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you create a policy, you specify the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Conditions of the policy, including standard and custom conditions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A workflow of steps."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-policy","__idx":1},"children":["Create a policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a policy:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Policies"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create a policy"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the policy 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 policy:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The policy name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional information, including a description and any custom properties."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The rank: The order of precedence of the policy relative to other eligible policies."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditions a proposed intent must fulfill for the policy to apply:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Governing scope:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Self"]},": Only applies to intents submitted in the current domain"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Descendants"]},": Only applies to intents submitted in subdomains of the current domain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Self and Descendants"]},": Applies to intents submitted in both the current domain and its subdomains."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Scope of application:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Applies to all intent types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Applies to specific intent types: Select the intent types the policy can apply to."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Other conditions the intent must fulfill for the policy to be selected:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Standard conditions expressed as key-value pairs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom conditions.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#custom-conditions"},"children":["Learn more about custom conditions"]}]}]}]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"You can view the conditions in JSON format in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Preview"]}," tab."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Workflows"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Details of the approval workflow to apply to the intent:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Always reject: The intent is rejected without user intervention."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Approval workflow with one or more steps. Each step includes the following:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An approval group: One or more users with a particular user role that must approve the intent."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optional conditions: Additional approval groups separated from each previous group by ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AND"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OR"]},", to specify if the current group must approve in addition to the previous group, or can approve instead of them."]}]}]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The submitter of the intent is always the first approver, so the role of the first step must correspond with the user role that can create the specified entities."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Summary"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This page is for review and submission only."]}]}]}]}]},{"$$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 new policy is created when the intent is successfully executed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"custom-conditions","__idx":2},"children":["Custom conditions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Custom conditions consist of two key-value pairs in JSON format: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expression"]},". The expression is written as a JavaScript expression."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ","Ripple Custody"," tests the conditions after intent submission, if the expression evaluates to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", then the policy is eligible to apply to the current intent."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creation of custom conditions is a technical task best performed by users with a good understanding of JSON and JavaScript."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information on how to write custom conditions, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/custody/v1.19/api/environment/policy/conditions"},"children":["Conditions"]}," in the API documentation."]}]}]},"headings":[{"value":"Create policies","id":"create-policies","depth":1},{"value":"Create a policy","id":"create-a-policy","depth":2},{"value":"Custom conditions","id":"custom-conditions","depth":2}],"frontmatter":{"seo":{"title":"Create policies"}},"lastModified":"2025-11-04T22:51:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/custody/v1.19/ui/environment/policy/create","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}