Skip to content

Allowlisting a token approves it for use in Ripple Custody. Allowlisted tokens are visible in the Assets Management screen and can be used in transfer orders.

What happens when you allowlist a token

When you allowlist a token:

  • The token moves from unclassified or denied tabs to the Asset Management screen
  • Token balances become visible in account views
  • You can create transfer orders using the token
  • Historical transfers involving this token become visible

Allowlisting a token also makes any historical transfers involving that token visible in the UI.

Allowlist one or more tokens

To allowlist one token:

  1. Go to Settings and then Asset Management.

  2. Click the Unclassified tab.

  3. Find the token(s) you want to allowlist.

  4. Click Allow at the end of the token row. You can select multiple tokens at this stage.

    Allowlist action for a token

  5. Click Submit for Approval.

  6. On your mobile device, open the Ripple Custody Auth & Sign app and sign the intent.

Selecting multiple tokens for allowlisting creates a single intent containing all selected tokens, which requires only one signature.

Confirmation dialog

Before submitting, the confirmation dialog shows:

  • The number of tokens being allowlisted
  • The intent details for review

Intent confirmation dialog for allowlisting tokens

Review the intent payload

Before signing, you can expand the intent payload to review the JSON. The payload contains the token details and the action being performed v0_ValidateTickers.

Reviewing the intent payload ensures you are signing exactly what you expect. This is especially important for bulk operations involving multiple tokens.

After allowlisting

The tokens are allowlisted when the intent is successfully executed. The tokens will now appear in the Assets Management screen.