rmResident Tenant Setup

rmResident is a secure, easy-to-use mobile app designed specifically for your renters. Leveraging the power of our Tenant Web Access (TWA) portal, residents can use the app to effortlessly make and view payments, review existing maintenance requests or submit new ones, and more.

If you already have TWA, your tenants can download the app from the App Store or Google Play and log in using their TWA credentials. rmResident is included with Tenant Web Access, and no additional setup is needed for your tenants to use the app.

More Information

The features available to tenants in rmResident are controlled by your Tenant Web Access settings, managed in the TWA section of system web preferences. Any pages you make available in TWA are also available in the app.

Tenants log into the app with their Tenant Web Access credentials. If they don't currently have a TWA account, a new web user account needs to be created. You can create a new account for them through TWA Settings on the tenant's General tab or if Allow Tenant To Create Accounts is enabled under Accounts in the TWA section of system web preferences, tenants are able to sign up for TWA on their own.

To get your tenants up and running with rmResident as quickly as possible, we've created a letter template you can send with instructions on how to download and log into the app. The letter uses scripting to dynamically update with personalization for your tenants and the properties in which they live.

This letter is available in the Online Template Library (OTL).

Step 1: Download the rmResident Letter Template from the OTL

To download this template, do the following:

  1. Go to Admin Online Template Library.
  2. Select the Tenant Letters folder and double-click to open it.
  3. Select the Announcing the rmResident App template.
  4. Click Download .
  5. Accept the terms and click OK.
    The template is downloaded to your database.

Step 2: Customize the Letter Template

The template is a great starting place but should also be customized to fit your use of rmResident. The highlighted fields must be updated for your database. You may also consider updating the introductory text and closing or adding any additional information your tenants may find useful.

Click to expand any step below to get more information on customizing the letter template.

  1. Go to Correspondence Letter Templates.
  2. Select the Announcing the rmResident App template from the list and double-click to open the word processor.

The template provides a quick introduction to the app and the way your tenants may use it. Be sure to add features you use which aren't listed and remove features listed which you do not use.

After the tenant has downloaded the app, they need to complete the initial setup. To complete this setup, the tenant is asked to provide a company code and, if applicable, a community. The required company code is scripted into your letter already.

Field Description
Community
(if applicable)

If your company uses locations, the community is the name of the database location in which the tenant's data is stored. The scripting in the letter template adds the name of the database location from which the letter is currently being generated.

Warning

If your database has only a single location, your tenants are not asked to provide a community when setting up rmResident. Remove this line from the letter template.

Step 3 in the letter template is scripted using an If function to provide your tenants who already have a web user account with their TWA username. For tenants without an existing account, this script instead instructs them to click Sign Up in the app to create a new account and provides the tenant with their account number (which is required to create their account). The script breaks down as follows:

  1. The IF condition is defined to determine if the tenant has an existing TWA account.
  2. If the tenant has an existing account, the letter displays the text Log in with your TWA account: and provides the tenant with their username.
  3. If the tenant does not have an existing account, the letter displays the text Click 'Sign Up' to create an account. Your account number is and provides the specific tenant's account number.

Warning

Part three of the If function should be used only if Allow Tenant To Create Accounts is enabled under Accounts in the TWA section of system web preferences. If you do not allow tenants to create their own accounts, replace part three of the script with your own text (e.g., Contact us to set up your account.).

Click Save .

To make your template available in the letter and tenant right-click menus, do the following:

  1. Go to Correspondence Letter Templates.
  2. Select the Announcing the rmResident App template from the list and click Settings.
  3. In the Menus section, check the box for both the Letter Menu and Right-Click Menu.
  4. Click Save.

Step 3: Send the Letter to Tenants

You can send the letter from the right-click menu or the letters menu.

Use the Right-Click Menu

To generate your letter using the right-click menu, do the following:

  1. Go to Rental Info Tenants.
  2. Select one or more accounts from the list on the left.

    To select multiple accounts use any of the following methods:

    • Hold the Ctrl key while selecting accounts.
    • To select a group of accounts, click the first account and then hold the Shift key while clicking the last account. All of the accounts between the first and last are selected.
    • Press Ctrl+A on your keyboard to select all accounts.
  3. Right-click on the account(s) and in the menu, select Write Letters, and then select the Announcing the rmResident App letter.
    Rent Manager generates the letter.
  4. In the Documents panel, locate Email, and click All.
    The Batch Email pop-up opens.
  5. Adjust your From Name, From Address, and Subject as needed.
  6. From the Attach As drop-list, select HTML.
  7. Under the Addressee List, select Use merged Document as Body.
    Rent Manager uses the letter as the body of the email.
  8. Select Add to History and click Send.

Use the Letters Menu

To generate your letter using the Letters menu, do the following:

  1. Go to Correspondence Write Letter Batch select Tenant and then select the Announcing the rmResident App letter.
    A pop-up displays with any options necessary to generate the letter.
  2. Select the appropriate options and click Run Letter Batch.
    Rent Manager generates the letter.
  3. In the Documents panel, locate Email, and click All.
    The Batch Email pop-up opens.
  4. Adjust your From Name, From Address, and Subject as needed.
  5. From the Attach As drop-list, select HTML.
  6. Under the Addressee List, select Use merged Document as Body.
    Rent Manager uses the letter as the body of the email.
  7. Select Add to History and click Send.