A Person in Tangilla is an individual. Each individual has one Person record in Tangilla. Information recorded against a Person includes
An Office in Tangilla is represented by an Office NRDS Record. Much of the data held for an Office is sourced from the Office NRDS Record. Tangilla also stores some additional information on an office in the context of your Association. These details are visible under the Office Profile tab in the Edit Office window.
A Role in Tangilla describes this Person's Relationship with the Association in the context of an Office.
A Relationship in Tangilla is the intersection of a Person, an Office and a Role.
e.g. Peter Jones is the Designated REALTOR for ABC Realty
A Product in Tangilla describes a service that a Person has a Subscription to. Examples include Association, MLS and Key Service. Products have various Product Types.
A Product Type in Tangilla describes the type of service that a Person's Product Subscription entitles them to.
Examples may include:
The Product Type specifically describes what the Product Subscription pays for, and by default, also describes the service that the Person has access to. It is however possible that the Person may receive access to a different Product Type that the one their Subscription pays for. This is the result of a Product Override.
Brokers may have a business need to Delegate broker level access in the member portal to a team member to help manage operations. Team members with this access are called Delegates. You may assign an unlimited number of Delegates. When a Delegate is assigned, the Designated REALTORS, Office Contact Manager and all other Delegates are notified.
Note: As part of the migration process for this new feature as of 2022/04/18, every broker delegate in a branch office was assigned an Office Broker Delegation access. Delegates in a main office were granted Group access.
A Product Override in Tangilla occurs where a Broker (or their Delegate) can provide an override to a Person's default Subscription access. This is most common with an MLS Subscription where a Broker (or their Delegate) may assign a Product Override to a Person that for that Subscription provides them a different level of access to the one they pay for.
For example, A Broker has an assistant. The Assistant has an MLS Subscription that provides Assistant level MLS Access, however the Broker wishes to grant them Office Manager Access. To achieve this a Product Override is used. The Product Type in the Subscription remains (and is billed as) Assistant, however the Product Type that is provisioned to the service (in this case, the MLS) is Office Manager.
Any Product Override is revoked automatically on any Office move related to the Subscription.
Product Overrides are specifically configured for your Association on migration to Tangilla. Changes to their configuration are managed via our support team.
When you click on any person from your People search, you will be taken to the subscription tab. The subscription tab will provide your first look at the person details that are shown in the left sidebar (Subscription Sidebar) of the Tangilla app.
The People Sidebar has two elements. The Person Card and the Relationship Card/s. A Person has one or more Relationship.
At the top of the People Sidebar is information specific to the Person record. This includes their photo, if it exists in the system, their name, their Person Mobile Number, their email, their Primary Association and their NRDS Number, their Tangilla PersonID (PID), their NRDS status and access to their Profile and Member Portal.
Clicking on the Profile button, causes the Edit Profile screen to pop out from the right side of the screen. This menu allows you fill out or update the basics for a member’s profile. Up top you see the “Profile” header with the member’s name, "Jette Youngblood," and right below that are the core identity fields: First, middle, and last names are laid out in a row, with “First Name” and “Last Name” marked as required (the little red asterisk). A short “Gen.” box sits on the right for a suffix like Jr. or III. The next row offers a “Preferred Name” box so you can note what the member actually wants to be called, plus a field for their mobile number. Beneath that, you have the “Member NRDS ID” field—important for REALTOR® associations—followed by an “Email” field that’s also required and a separate slot for a “Billing CC Email” if invoices need to copy someone else.
Lower on the form you can capture government‑issued details: a box for the driver’s‑license number and a dropdown for the issuing state. Finally, two yes/no radio‑button choices handle compliance settings—one for whether the member has opted out of RPAC contributions and another that marks the account as tax‑exempt. A bold “Save” button in Tangilla orange anchors the bottom left corner so you can lock in whatever you change.
Note: when you edit a persons email in the profile, it only updates the association subscription, it does not update the MLS Subscription, since a person can have multiple MLS Subscriptions, with multiple email address and phone numbers. To edit the email for subscriptions, you and the member need to make those changes directly in thos subscriptions.
When you enter the Member Portal via the Portal Button, you are entering with special permissions that allow you to act as if you were the agent inside the Tangilla Member Portal. However, you are NOT entering with any of the SSO permissions that may exist when connecting to outside services from their portal. Your permissions extend only to what the member can do inside of the Tangilla member portal.
When a newly created record includes in the initial form an e-mail address that already exists in a different account in M1, as per M1's suggestion we add an extra "+###" where "###" would be the agent's NRDS number. Any e-mails sent to addresses that have a "+" and anything else written after will still send to the correct address written before the "+", and with this we avoid duplicating an e-mail address in M1.
Any segment can be turned into a Segment Tag that will appear on the members Person record. This was designed to be used to provide valuable information about people who may fit into special categories of members, such as the Board of Directors. The tag will display below the Profile and Portal buttons so you can understand their unique position in the Association or MLS.
You can learn more about how to apply a Segment Tag here: Segment Tags.
Segment Tags should be used sparingly. Creating a Segment Tag for a segment that contains a large percentage of the members will not provide a great deal of value. The goal of the Segment Tag feature is to highlight special relationships.
When you land on this page, the Relationship Card in the People Sidebar will be open if there is only one card and closed if there are multiple. This contains their Role in that Office, the office address, their license number, license expiration date, license status and IDP Username. Clicking on the Office Name in the title will take you to that Office in Tangilla. Clicking on the - - or - - icon in the top right of the tab will open and close the individual office display. If the person has multiple relationships, multiple Relationship Cards will be displayed.
The subscriptions dashboard shows all of the Subscriptions that a person has, by Office and Product Type. The three common subscription types are Association, MLS and Key Services. These are each displayed in the context of the Relationship they are held against.
If a person has multiple Relationships, this dashboard might look more like the one below. Again, each Subscription is related to the Relationship and sorted by Office.
Each Subscription has its own details which may be viewed/edited. Changing the email or phone number on one subscription does not change that email or phone number in a separate product/subscription. If a user wants their emaail or phone numberr changed on both the association and the MLS they would need to make that change in both places. This is because a person can have multiple MLS subscriptions, each with different contact information.
The Association subscription is the NRDS record for this Member in this office. The fields available to be edited are determined by Tangilla as well as the NRDS security rules (only Primary Local and State Associations can edit Primary NRDS Records).
Incidents are how Subscription related issues are managed in Tangilla.
When Tangilla detects an issue with an account that results in the suspension of services, an Incident is raised. Some Incidents can raise related Incidents, on either the same member profile, or another member profile (based on Product or Member dependencies).
Grace Period
: If an incident is triggered, members may be given a period of time to resolve the incident before suspension occurs. System defaults are used unless Tangilla has been instructed to make modifications to these for a tenant. Only parent incidents may have a Grace Period
applied. The Grace Period
date and time is listed in the system email and agent portal.
Incidents are resolved when the condition that gave rise to the Incident is rectified. For example a license suspension/expiry Incident is resolved, when the license becomes active again. Often this occurs without specific intervention by staff.
Most Incidents are resolved automatically once the condition giving rise to the Incident is no longer applicable - eg a License is active again.
When an Incident is raised, both the members that it relates to, along with members that are impacted are notified via email.
Similarly, when an Incident is resolved, both the members that it relates to, along with members that were impacted are notified via email that the Incident has been resolved.
This Incident heirarchy means that provisioning of services can be managed on each account without needing to make changes to the account's settings and therefore mitigating the risks associated with the suspension of services.
Some definitions that may be helpful.
There are a number of Incident types that can occur in Tangilla, each are defined below.
By default, this incident type has no
Grace Period
and is applied immediately
This is resolved automatically, without interaction by staff.
By default, this incident type has no
Grace Period
and is applied immediately
This is resolved automatically, without interaction by staff, upon a successfull Office Transfer.
By default, this incident type has a
Grace Period
of 3 days.
In states that support automated license data feeds, this is resolved automatically, without interaction by staff.
By default, this incident type has a
Grace Period
of 3 days.
This is resolved automatically, without interaction by staff.
By default, this incident type has a
Grace Period
of 3 days.
Course Requirement
listed on their record.This is resolved automatically, without interaction by staff.
By default, this incident type has a
Grace Period
of 3 days.
This is resolved automatically, without interaction by staff.
By default, this incident type has a
Grace Period
of 3 days.
This is resolved automatically, without interaction by staff.
By default, this incident type has a
Grace Period
of 3 days.
This type of incident may require staff intervention depending on the polling frequency.
By default, this incident type has a
Grace Period
defined at incident creation.
This is resolved manually at the discretion of staff.
This is resolved automatically, without interaction by staff.
Some subscriptions can dependent on a valid subscription of another product for some types of Members. As an example a Key Services product may be dependent on a valid MLS subscription.
When this is the case, these dependencies flow into incidents.
Taking our example, if a Key Services subscription, was dependent on an MLS subscription and the MLS subscription was suspended due to an incident, then the Key Services subscription would also be suspended and the incident against that subscription would be {incident_type}_related_product e.g. non_payment_related_product.
If an subscription was suspended due to a broker_suspension, and there were dependent products for the suspended product then each of those dependent products would also be suspened with an incident type of broker_suspension_related_product.
This is resolved automatically, without interaction by staff.
The main signal for Secondary Members who have an MLS Only relationship is related to their NRDS status. This is monitored by a MLS Verfied job that runs once weekly. This gives most people time to resolve mistakes with their Primary Association. When a MLS Only subscrsiber's NRDS status goes inactive, their subscriptions with your association will not be suspended until the weekly MLS Verified job runs.
Most incidents are created by Tangilla as a result of monitoring.
On occasion, you may need to create an incident manually. This is supported via the Association Incident type.
The description and comments for the incident for are shared with the Member.
Most incidents are resolved automatically once the condition giving rise to the incident is no longer applicable - eg a Licence is active again.
Those that are not can be resolved by clicking the checkbox available as an action. Some actions will check the state of the incident and resolve if possible.
Child incidents now have an option to view the parent incident.
You can see the details of the parent incident by clicking on the - - Icon next to the incident it is related to.
Deprovisioning will begin as soon as an incident is triggered. You will be UNABLE to resolve an incident that is in the process of deprovisioning, even one you have initiated, until it has completed deprovisioning.
Click on the - - icon and the Amendments dashboard will slide out from the right side of the screen. Any amendments related to this subscription will appear here. You may search by product and sorty by Created, Type, Status, Status Date, and Effective date. You may also filter by Status (Pending, Cancelled, Complete) or by Type (Add, Remove or Change).
You can cancel or resolve an amendment by clicking on the - - icon for any active amendment. This will cause the warning window to pop up to make sure this is what you wish to do.
If enabled, the Child Product Type feature enables a separation of membership subscriptions. This feature handles specific subscriptions by splitting them into multiple products. This special configuration allows you to split billing when using different billing periods the Child Product Types or to a different billing configuration for each in general.
Using this feature also links both products (Primary and Child Product Types) so that incidents and amendments on one of them will affect both.
Example: It is now possible to separate National & State membership dues from Local membership dues. Non-payment of one results in suspension of all.
There are a number of ammendments staff can initiate (add or create) against subscriptions that will take immediate effect upon execution. These options will only appear for you if you have the right entitlements or permissions.
If you need to cancel a Subscription, but the bill period invoice has not been paid yet, the following process must be followed.
If you need to cancel a Subscription, and the bill period invoice has already been paid, the following process must be followed.
If you need to Change a Product Type without collecting payment from the person, the following process must be followed.
If you need to Change a Product Type and also need to collect payment from the person, the following process must be followed.
If you need to add or reinstate a terminated product and you DO NOT NEED to collect payment from the person, the following process must be followed.
If you need to add or reinstate a terminated product and you DO NEED to collect payment from the person, the following process must be followed.
# | Question | Answer |
---|---|---|
1 | What is a subscription in Tangilla? | A subscription in Tangilla refers to the services a person is enrolled in, such as Association, MLS, or Key Service. Each subscription includes a product and product type that define the access and services provided. |
2 | How are subscriptions organized in Tangilla? | Subscriptions are linked to the individual's relationships with specific offices and roles. Each relationship can include different product subscriptions organized by office and product type. |
3 | What is a product override? | A product override allows a broker or delegate to change a person's subscription access level without altering the subscription's billing level. For instance, upgrading access from Assistant to Office Manager. |
4 | What is shown in the People Sidebar? | The People Sidebar includes the Person Card (with contact and identity details) and one or more Relationship Cards (showing role, office, and license information). |
5 | What are incidents in Tangilla? | Incidents are subscription-related issues that may result in service suspension or termination. They are triggered by conditions like non-payment or license expiration and are resolved when the issue is corrected. |
6 | What is a Grace Period in relation to an incident? | A Grace Period is the time given to a member to resolve an incident before service suspension. Only parent incidents may have a Grace Period, typically lasting three days unless otherwise specified. |
7 | What is the difference between suspension and termination? | Suspension allows reactivation via the member portal, while termination means the member must reapply through a new application after services are cut off following unresolved incidents. |
8 | How can incidents be resolved in Tangilla? | Most incidents resolve automatically when their triggering condition is cleared (e.g., license reactivated). Others may require manual resolution by staff via the Tangilla interface. |
9 | What is a Segment Tag and when should it be used? | A Segment Tag highlights special member categories like the Board of Directors. It should be used sparingly for small, distinct groups to provide quick recognition in the Person record. |
10 | How do I mark someone as tax exempt? | Open their profile from the Person Card and set the "Tax Exempt" radio button to "Yes" at the bottom of the form. |
11 | What happens when a product override is applied? | The subscription remains billed at the original product type, but the access provisioned reflects the overridden type, giving the member access to different services. |
12 | What is shown on the Subscriptions Dashboard? | It displays all of a person’s subscriptions, organized by Office and Product Type, and grouped under the relevant relationship. |
13 | How can staff edit a subscription’s details? | Subscription details can be edited based on permissions and NRDS rules. Primary Associations can edit Primary NRDS Records through the Tangilla interface. |
14 | What triggers a non_payment incident? | It occurs when a dues invoice remains unpaid after the Suspension Date. It affects both the individual and their office colleagues if the person is a DR. |
15 | What is a broker_termination incident? | It happens when a DR ends their relationship with the office. It's resolved when the affected person transfers to a new office. |
16 | What is the coe_requirement_not_met incident? | This is triggered when a member fails to complete their NAR Code of Ethics training. It resolves automatically once compliance is confirmed. |
17 | What are _related_product incidents? | These occur when a product is dependent on another, and the parent product’s incident triggers a related incident in the dependent product, such as key services relying on an active MLS subscription. |
18 | When are MLS Only incidents checked? | These are reviewed weekly through the MLS Verified job to allow time for corrections before suspensions are enacted. |
19 | How do staff manually create an incident? | Use the Association Incident type via the interface, add a description and comments to inform the member and staff. |
20 | How do I cancel a subscription with an unpaid invoice? | Add a staff amendment of type "Remove," and upon completion, the subscription is terminated and the invoice is automatically adjusted. |
21 | What is required to cancel a subscription with a paid invoice? | The subscription is removed via a staff amendment, and any refunds or deprovisioning must be handled manually afterward. |
22 | How can I change a product type without payment? | Use a "Change" staff amendment, select "No Linked Invoice," and complete the process to immediately update the subscription. |
23 | How do I change a product type with payment? | Create an ad hoc invoice first, then link it during the amendment process. The change takes effect after payment is made. |
24 | How do I reinstate a subscription without payment? | Use a staff amendment of type "Add" without linking to an invoice, which takes effect immediately. |
25 | How do I reinstate a subscription with payment? | Create and link an ad hoc invoice to the "Add" amendment. The reinstatement completes once payment is made. |
26 | What is a Child Product Type? | It's a special configuration that separates membership dues into different products for billing or administrative purposes, such as separating local and national dues. |
27 | What happens during deprovisioning? | Deprovisioning begins as soon as an incident is triggered and must complete before the incident can be resolved, even manually. |
28 | What is the Amendments dashboard used for? | It displays all changes made to a subscription, allowing sorting and filtering by type, status, and date. |
29 | How can I delete or resolve a subscription amendment? | Use the trash icon in the Amendments tab to cancel or resolve pending amendments. A confirmation prompt appears before action is taken. |
30 | What is the Parent Incident View feature? | It allows users to trace child incidents back to their parent, providing context and visibility into cascading issues. |
31 | How do I mark someone as non-taxable or tax exempt? | Click on the profile button on the person record and at the bottom there are two radio button options, on for RPAC Opted Out and one for Tax Exempt. If you want to make a member or subscriber as tax exempt, make the Tax Exempt as "yes." |