Skip to main content

Customize Account Display

Account information is displayed in many locations throughout the app. To customize the content and formatting of account information, you can edit account_display.json. Most account data is in the form of a balance (for example, "Available Balance," or "Current Balance") but the account_display.json configuration can be used to display non-balance data as well (for example, "Account Number").

Account information is displayed using multiple rows. For example, the checking account display on the dashboard view shows the following information on different rows:

Account information is typically displayed in a "stack" or series of rows. "Locations" are contextual locations in the app where account data is typically displayed.

  • Account name
  • Available balance
  • Balance
  • Pending balance (if available)

To customize an account display:

  1. Copy account_display.json from client/default/config/account_display.json to institutions/config/accout_display.json.
  2. Search for the name of the contextual location where you'd like to customize the account data presentation.
  3. If you want, change the max number of rows (num_rows_max) that display at this location.
  4. Add to or edit the list of balance rows.

Add and Customize Balance Rows

balance_rows display rows of information wherever an account is shown. You can add new rows and customize them.

CustomizationDescription
typeType of data that displays.
display_optionWhen the row displays.
balance_behaviorThe text color used.
show_alertA boolean which shows an alert on the row and sets the text color to DESTRUCTIVE.
icon_typeUsed on the account details view. Lets the user edit a specific detail or copy it to their clipboard. Defaults to NONE. Can set to EDIT or COPY.

Set Type of Data that Displays

type indicates what data gets displayed. The data displays on one or both sides of the row.

TypeLeft Text ExampleRight Text Example
BALANCEBalance$1.23
AVAILABLE_BALANCEAvailable Balance$1.23
PENDING_BALANCEPending Balance$1.23
PENDING_CREDITPending Credit$1.23
ORIGINAL_BALANCEOriginal Balance$1.23
AVAILABLE_CREDITAvailable Credit$1.23
CREDIT_LIMITCredit Limit$1.23
MINIMUM_PAYMENTMinimum Payment$1.23
MINIMUM_PAYMENT_LEFT_ONLYMinimum payment of $1.23 due
PAYOFF_BALANCEPayoff Balance$1.23
STATEMENT_BALANCEStatement Balance$1.23
DUE_DATEDue DateMarch 4, 2016
DUE_DATE_LEFT_ONLYPayment Due On Fri, Mar 4
DUE_DATE_WITH_AMOUNT_LEFT_ONLYMin $1.23 Due On Fri, Mar 4
INSTITUTION_NAMEEpic Bank
INSTITUTION_NAME_ACCOUNT_NUMBEREpic Bank123456789
ACCOUNT_NUMBERAccount Number123456789
ACCOUNT_NUMBER_ONLY123456789
ACCOUNT_NUMBER_BALANCE123456789$1.23
PRODUCT_NAMEProduct NameBig Checking
ACCOUNT_NAMEAccount NameBig Checking
ACCOUNT_NAME_ONLYBig Checking
ACCOUNT_NAME_BALANCEBig Checking$1.23
ACCOUNT_NAME_AVAILABLE_BALANCEBig Checking$1.23
ACCOUNT_NAME_WITH_ACCOUNT_NUMBERBig Checking 123456789
ACCOUNT_NICKNAMENicknameBob's Big Checking
APRAPR (%)3.000%
APYAPY (%)3.000%
INTEREST_RATEInterest Rate3.000%
ROUTING_NUMBERRouting Number123456789
MINIMUM_BALANCEMinimum Balance$1.23
HOLDINGS_VALUEHoldings Value$1.23
LAST_PAYMENTLast Payment$1.23
MATURES_ONMatures OnMarch 4, 2016
PURCHASE_APRPurchase APR (%)3.000%
STATEMENT_DATEStatement DateMarch 4, 2016
CASH_ADVANCE_APRCash Advance APR (%)3.00%
PROPERTY_TYPEProperty TypeJewelry
PAST_DUE_AMOUNTPast Due Amount$1.23
DAYS_PAST_DUEDays Past DueMarch 4, 2017
STARTED_ONStarted OnMarch 4, 2017

Define When the Row Displays

display_option controls when the row displays.

Display OptionDescription
ALWAYS_SHOWAlways displays.
NEVER_SHOWNever displays.
ONLY_IF_AVAILABLEOnly displays if the account has the values the type requires.
ONLY_IF_NONZEROOnly displays if either the left or right section of the type displays a non-zero balance.
ONLY_IF_PAST_DUEOnly displays if there's a past due balance on the account.

Set the Text Color Behavior

balance_behavior sets the text color for the info you're displaying. If your type doesn't contain a balance, you must set it to NON_BALANCE.

By default, all balance behaviors use the STANDARD text color.

This table shows all balance behaviors and any text colors they use:

Balance BehaviorText Color
NON_BALANCEUsed for a type that's not associated with a balance (or numeric) value, like ACCOUNT_NAME. Always uses STANDARD.
STANDARD_BALANCEAlways uses STANDARD.
ASSET_BALANCEIf the balance is overdrawn, uses LIABILITIES.
LIABILITY_BALANCEIf the balance contains excess money, uses GAINS.
PAST_DUE_ASSET_BALANCEIf the balance is overdrawn, uses LIABILITIES. If the balance is past due, overrides any other text color and uses DESTRUCTIVE.
PAST_DUE_LIABILITY_BALANCEIf the balance contains excess money, uses GAINS. If the balance is past due, overrides any other text color and uses DESTRUCTIVE.
PAST_DUEIf the balance is past due, uses DESTRUCTIVE.

Locations

Location Type
DASHBOARD
ACCOUNTS_LIST
ACCOUNT_DETAILS_HEADER
HOME_ACCOUNT_DETAILS_ADDITIONAL_BALANCES
EXTERNAL_ACCOUNT_DETAILS_ADDITIONAL_BALANCES
TRANSACTION_DETAILS
TRANSFER_SOURCE
TRANSFER_DESTINATION
CROSS_ACCOUNT_TRANSFER
PAYOUT_SOURCE
PAYOUT_DESTINATION
PAYOUT_DETAILS
PAYMENT
PAYMENT_DETAILS
REMOTE_DEPOSIT
QUICK_SAVE_SOURCE
QUICK_SAVE_DESTINATION
DOCUMENT_LIST
ACCOUNT_REORDER
INSTITUTION_DETAILS_ACCOUNTS