Customize

In Argyle Link, you have the flexibility to tailor and brand user interface elements to fit your specific use case. Using Flows in Console, you can tune everything from your company logo, to the button text, to which employers and payroll providers are available for users to connect. You can even set up manual verification flows, like the document upload experience, for users that are unable to connect their payroll account. Keep reading to learn the specifics about all customizable Link features.

Start customizing

To start customizing Link, open Flows then select an existing customization or create a new one. Name your customization to differentiate between your customization use cases. You can create new customizations of Argyle Link from within Argyle Console.

You can create new customizations of Argyle Link from within Argyle Console.

Set available income sources

On this screen, you can customize these features under the Search, List, and Deep link sections:

Parameter	Description
Available categories of Link items (Search browsing experience)	Excludes one or more categories (and their respective Link items) from the Search screen.
Exclude specific Link items (Search browsing experience)	Use this parameter to limit the number of Link items that your users can connect. Provide an array of Link item IDs you want Argyle Link to exclude in the Search screen.
Search and choose from over 20,000 Link items	Use this parameter to limit the number of Link items that your users can connect. Provide an array of Link item IDs you want Argyle Link to display on the Search screen. The order in which you list the IDs will define the order in which they are displayed in the UI.
Only show Link items that support direct deposit switching	When toggled on, only Link items that support direct deposit switching will be shown. For more information on changing direct deposit settings, please refer to our direct deposit switching guide.

Search

Customize your Link search settings to help your users find relevant Link items faster. Here you can view the Link items that your users can search. Under Available categories of Link items, tick the boxes of the categories you wish to display. You can display Employers, Gig platforms, and/or Payroll providers. Choosing which tabs are displayed on Argyle Link's search screen.

You also have the option to exclude specific Link items that you do not wish to make available, or to surface only those Link items that support direct deposit switching.

List

Specify the Link items you want to make available to your users. Your users see only the Link items that you have selected. Users can search in Argyle Link from just a constrained list you specify.

Deep link

In some cases, you may want to deep link your users to connect them to one specific Link item. When your users open Argyle Link, they are prompted to log in to the deep linked Link item. You can also choose to deep link your users to the document upload experience. This user flow allows users to upload W-2 forms, 1099 forms, and paystubs. Include a customizationId in your Link initialization to see this option. To make this option available for returning users, you must also include a userToken in your Link initialization. Image showing the login screen of a specific employer or payroll provider in Argyle Link.

Image showing the login screen of a specific employer or payroll provider in Argyle Link.

Intro screen

In your Argyle Link implementation, the Intro screen provides context for your users on the service they are using. The Intro screen is enabled by default. Customize this screen to match the style of your own application and suit your business needs. Select Intro from the Customizer sidebar to design your Intro screen. From here you can customize:

Parameter	Description
Your logo	Your company logo.
Intro text	The text you display on the Intro screen.
Show info text	Option to show info text on the Intro screen.
Info text	Subtitle text on the Intro screen.
Primary button text	The title of the primary button on the Intro screen.
Show secondary button	Option to show a secondary button on the Intro screen. If you decide to enable the secondary button, you must configure the `onExitIntroClicked` callback programmatically.
Secondary button text	The title of the secondary button on the Intro screen.

You can customize almost every part of Argyle Link's introduction screen.

Select income source screen

You can customize your users’ search experience to help guide them to the correct Link items. From this screen you can customize:

Parameter	Description
Search placeholder text	Placeholder text in the search bar.
Show categories / suggestions	Show/hide Link item suggestions provided by Argyle.
Show Popular	Option to promote Link items to your users.
Popular Link Items	The Link items you want to promote.
No results text	The title for the Can’t find your income source? button when no Link item is available. This button is shown by default but can be disabled.

“If no results” experience

This experience provides alternative flows for your users if they cannot find their income source or payroll provider.

If the user cannot find their income source on Link’s Search screen, they can select the Can’t find your income source? button and search among the payroll providers covered by Argyle to access their accounts.
If the user cannot find their payroll provider, you can direct them to the Form or Document upload experiences.

If you only enable “Gig” Link items in the set available income sources screen, the Can’t find your income source? button excludes this payroll provider search option from the flow and directs users to the Form or the Document upload experiences.

On this screen you can select and customize the experience that fits your application:

Parameter	Description
Form	Select this experience to enable the income source form for users who cannot find their payroll provider. Consult Link fallback flows for more information.
Document upload	Select this experience to enable the document upload flow for users who cannot find their payroll provider. In this flow, users can upload PDF or image files of W-2s, 1099s, and paystubs for income verification. Consult document uploading for more information.
Callback	Select this experience to close Link and direct users to a specific part of your application or website. The callback triggers after the user selects the Can’t find your income source? button in Link. To enable this user flow, you must also define the `onCantFindLinkItemClicked` callback in your implementation. Consult our Link reference for technical details about this callback.

Customizing the text shown in search when there are no results.

On the Login screen, you can elect to enable the manual verification flow for users who are not able to log in to their payroll account. See the table to understand which features of this flow can be customized:

Parameter	Description
Allow deep linked users to navigate to Search screen	Option to allow deep linked users to navigate to the Search screen.
Document upload if login failed	Option to allow users to upload documentation if they are unable to log in. Select if login failed to enable Document upload to allow users to upload paystubs, W-2 forms, and 1099 forms.
Submit button title	Title of the submit button for uploaded documents.
Submit button description	Description of the submit button.

What is shown in Argyle Link to the user when they enter invalid credentials or otherwise cannot login to their payroll account.

You can customize the submit button text on the document upload screen in Argyle Link.

Success screen

When users successfully connect their account, they see a Success screen. Here you can customize:

Parameter	Description
Allow users to connect additional accounts	If set to false, hides the Return to search button in the Success screen.
Connect more accounts button title	The title for the Return to search button in the Success screen.
Exit button title	A value to override the default title of the Done button shown in the Success screen.

Customizing the success screen shown in Argyle Link after a successful payroll account connection.

Global UI settings

Global UI settings are settings that apply on multiple screens throughout Link. Navigate to the Global UI settings to customize:

Parameter	Description
Company name	Your company or app name to display in the UI of Argyle Link (for example, “your account is now successfully connected to Company Name”).
Your company logo	Your company logo.
Show close button	Toggles the visibility of the Close button. This flag works only on the web implementation of Argyle Link (and not on the mobile SDKs).
Close on outside click	Toggles the closing of Link when a user clicks outside the bounds of the UI element provided by Argyle. This flag works only on the web implementation of Argyle Link (and not on the mobile SDKs).

Certain UI elements common to multiple Argyle Link screens can also be customized.

Document upload settings

Visit the Document upload settings to configure document upload options for your users. Customize these features:

Parameter	Description
Deep link to document upload	Option to upload income verification documents without the user logging in to their employer or payroll provider accounts.
If no results	Option to upload income verification documents if the user cannot find their employer or payroll provider.
If login failed	Option to upload income verification documents if the user is unable to log in.
Document list title	Title for the user’s list of uploaded documents.
Submit button title	Title of the submit button for uploaded documents.
Documents the user is asked to provide	The documents the user is asked to provide. This can be: paystubs, W-2 forms, or 1099 forms.

To learn more about the document upload flow, consult our document uploading documentation.

Preview your customization

Click the Preview button in the top right corner of the screen to see a preview of your customization with all changes applied. Click Exit Preview Mode to return to the Customization settings screens.

Customizations in Emulator

To test the functionality of your customization before applying changes in your Link instance, navigate to Flows. Select a customization to view the changes you have made.

Applying customizations

Once you have created your customization, copy the Customization ID from the main Flows screen and insert it into your Link configuration file to apply changes in your software. Choose a customization ID from the list in Console.

Choose a customization ID from the list in Console.

Example customization

Web
iOS
Android
React Native

<!DOCTYPE html>
<html>

<head>
    <meta charset="utf-8" />
</head>

<body>
    <script src="https://plugin.argyle.com/argyle.web.v3.js"></script>
    <script type="text/javascript">
        const argyle = Argyle.create({
        linkKey: 'YOUR_LINK_KEY', // insert your Link key here. It can be found in the Argyle Console.
        apiHost: 'https://api-sandbox.argyle.com/v1', // sandbox environment is used in this example. Change to production environment before launching.
        customizationId: 'YOUR_CUSTOMIZATION_ID' // insert your customizationId here
      })
      argyle.open()
    </script>
</body>

</html>

_ = Argyle.shared
    .loginWith(
        linkKey: "YOUR_LINK_KEY", // insert your Link key here. It can be found in the Argyle Console. 
        apiHost: "https://api-sandbox.argyle.com/v1") // sandbox environment is used in this example. Change to production environment before launching.)
    .customizationId("YOUR_CUSTOMIZATION_ID")
    .resultListener(self)

let argyle = Argyle.shared.updateToken(token).controller
argyle.modalPresentationStyle = .fullScreen
self.present(argyle, animated: true, completion: nil)

val config = ArgyleConfig.Builder()
    .loginWith(
        "YOUR_LINK_KEY", // insert your Link key here. It can be found in the Argyle Console.
        "https://api-sandbox.argyle.com/v1", // sandbox environment is used in this example. Change to production environment before launching.
        "USER_TOKEN") // insert the user token here
    .customizationId("YOUR_CUSTOMIZATION_ID")
    .setCallbackListener(object : Argyle.ArgyleResultListener {
        // callbacks
    })
    .build()

Argyle.instance.init(config)
Argyle.instance.startSDK(this)

ArgyleSdk.loginWith(
    "YOUR_LINK_KEY", // insert your Link key here. It can be found in the Argyle Console.
    "https://api-sandbox.argyle.com/v1", // sandbox environment is used in this example. Change to production environment before launching.
    "USER_TOKEN") // insert the old or new user token here
ArgyleSdk.customizationId("YOUR_CUSTOMIZATION_ID")
ArgyleSdk.start()

Customize deep linking and direct deposit switching settings

Some parameters cannot be customized via Flows. Learn how to customize these features in your Argyle Link instance programmatically by editing the Link configuration file. This section demonstrates how each of these parameters appears on Link. For a list of all parameters and their usage, refer to our Link configuration parameters reference. If you pass only one value in the linkItems parameter, then the Search screen will be omitted and the user will land directly on the Login screen. Users deep linked to the login screen bypass the search process in Link.

Users deep linked to the login screen bypass the search process in Link.

Enable direct deposit switching flow

You can enable the direct deposit switching flow to initiate right after an account is linked by including payDistributionUpdateFlow and payDistributionConfig in your Argyle Link initialization. Image showing the direct deposit switching flow in Argyle Link.

Image showing the direct deposit switching flow in Argyle Link.

Refer to our direct deposit switching guide for more information.

Display only Link items that allow direct deposit switching

In Argyle Console:

Create a new customization using Flows.
Enable the setting “Only show Link items that support direct deposit switching”.
Save and apply your customization by including the following line in your Argyle Link initialization:

customizationId: "<Your customization ID (e.g. P2R93PEL) found in Link Customizer>"

Overview

Workflows

POS & LOS Systems

Day 1 Certainty® and AIM

Document Processing

Console

Link

API

Start customizing

Set available income sources

Search

List

Deep link

Intro screen

Select income source screen

“If no results” experience

Success screen

Global UI settings

Document upload settings

Preview your customization

Customizations in Emulator

Applying customizations

Example customization

Customize deep linking and direct deposit switching settings

Enable direct deposit switching flow

Display only Link items that allow direct deposit switching

​Start customizing

​Set available income sources

​Search

​List

​Deep link

​Intro screen

​Select income source screen

​“If no results” experience

​Login screen

​Success screen

​Global UI settings

​Document upload settings

​Preview your customization

​Customizations in Emulator

​Applying customizations

​Example customization

​Customize deep linking and direct deposit switching settings

​Deep link users to the login screen

​Enable direct deposit switching flow

​Display only Link items that allow direct deposit switching

Start customizing

Set available income sources

Search

List

Deep link

Intro screen

Select income source screen

“If no results” experience

Login screen

Success screen

Global UI settings

Document upload settings

Preview your customization

Customizations in Emulator

Applying customizations

Example customization

Customize deep linking and direct deposit switching settings

Deep link users to the login screen

Enable direct deposit switching flow

Display only Link items that allow direct deposit switching