> For the complete documentation index, see [llms.txt](https://docs.rubica.au/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rubica.au/households/risk-profiles/setting-up-risk-profiles.md).

# Setting Up Risk Profiles

For admins: set up your firm's risk profiles, link your risk questionnaire to them, choose which score suggests which profile, and set how often risk profiles are reviewed.

This page is for whoever looks after your firm's rubica setup. You do it once, then change it whenever your firm's profiles, questionnaire or review policy change. Nothing here needs a developer.

We use **Collins SBA** as the worked example throughout.

## Before you start

* **The Risk Profiles screen.** Your admin adds the **Rubica Risk Profile Manager** component to a page in Lightning App Builder. Give it a full-width area, as the Profiles table is wide. Collins SBA has it on the Home page under **Settings → Risk Profiles**.
* **Access.** Anyone who manages profiles or agrees risk profiles needs the **Rubica Risk Profiles** permission set.
* **A risk questionnaire.** Build it in the [Form Builder](/households/forms/building-a-form.md) and give each answer a **score**. Turn on scoring for the form. Any scoring bands you typed in the Form Builder are replaced by the ranges you set on the **Questionnaire scoring** tab (step 3).

The Risk Profiles screen has three tabs:

| Tab                        | What you set there                                                           |
| -------------------------- | ---------------------------------------------------------------------------- |
| **Profiles**               | Your firm's profiles and their details                                       |
| **Questionnaire scoring**  | Which questionnaire you use, and which score suggests which profile          |
| **When a form comes back** | Whether returned questionnaires create risk profiles, and your review period |

## 1. Add your profiles

On the **Profiles** tab, click **+ New profile** for each profile your firm uses, in order from most defensive to most growth.

<figure><img src="https://3555949013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzoPnlIGiL5ejRdJEq5X%2Fuploads%2Fgit-blob-51028f67d4118dc63d8395f5f82ea0da0c0a0f89%2Frisk-profiles-admin-profiles.png?alt=media" alt="Collins SBA&#x27;s seven profiles on the Profiles tab"><figcaption><p>Collins SBA's seven profiles on the Profiles tab</p></figcaption></figure>

| Field                          | Collins SBA example (profile 4)                                         |
| ------------------------------ | ----------------------------------------------------------------------- |
| **Name**                       | CSBA 4/7 Balance 50:50                                                  |
| **Display order**              | 4                                                                       |
| **Growth assets**              | 50%                                                                     |
| **Long-term objective**        | CASH + 2%                                                               |
| **Minimum timeframe**          | 4-5 years                                                               |
| **Negative return likelihood** | 1 in 7.38 years                                                         |
| **Worst / best 12 months**     | -11.7% / +16.4%                                                         |
| **Average historical return**  | 6.4%                                                                    |
| **Suitability comments**       | Prefer steadier performance over time with some opportunity for growth. |

{% hint style="info" %}
**Use the same names your firm already uses.** The profile name is what advisers see when agreeing a profile and what's saved on the client. Collins SBA's names match the values already on their client records, for example *CSBA 4/7 Balance 50:50*.
{% endhint %}

**Import with AI** reads your profile document (a PDF, an image, or pasted text) and proposes the profiles for you. You review each one and choose what to keep before anything is saved.

To retire a profile, open it and make it **Inactive**. Profiles are never deleted, so older risk profiles that used it still make sense. **Change history** shows who changed what, and when.

## 2. Link your risk questionnaire

On the **Questionnaire scoring** tab:

1. Under **Link your risk questionnaire**, choose the questionnaire. The list shows every form that has scoring turned on. At Collins SBA that's the *Client Risk Profile Questionnaire* and the *Client Satisfaction & NPS Survey*; only the first is a risk questionnaire.
2. If your risk profiles record which questionnaire was used, choose it under **Recorded on the risk profile as**. Collins SBA uses *SBA Advice Investment Committee*.
3. Click **Link questionnaire**.

From now on, every time a client returns that questionnaire, a risk profile is created for them. It links back to the form they filled in, so the adviser can see every answer.

You can link more than one questionnaire, for example a short and a long version. Each has its own score ranges.

## 3. Choose which score suggests which profile

Still on **Questionnaire scoring**, each linked questionnaire shows:

* **Saved**: the score ranges as they are now, drawn as a bar.
* A table with a row per range: **From**, **To**, **Suggests this profile**, and **Returned in this range** (how many questionnaires that have already come back scored in that range).

For each row, set the scores and pick one of your profiles from the list. Collins SBA's ranges:

| From | To | Suggests this profile         |
| ---: | -: | ----------------------------- |
|   10 | 12 | CSBA 1/7 Cash 100:0           |
|   13 | 16 | CSBA 2/7 Conservative 85:15   |
|   17 | 20 | CSBA 3/7 Moderate 70:30       |
|   21 | 25 | CSBA 4/7 Balance 50:50        |
|   26 | 30 | CSBA 5/7 Balance Growth 40:60 |
|   31 | 35 | CSBA 6/7 Growth 30:70         |
|   36 | 40 | CSBA 7/7 High Growth 15:85    |

Use **+ Add range** and **Remove** to change how many ranges there are, then click **Save ranges**.

The ranges are checked as you type:

* **Overlaps are blocked.** If two ranges share a score (say *1/7* runs to 15 and *2/7* starts at 13), you'll see *"Scores 13–15 reach two profiles"* and **Save ranges** stays greyed out until you fix it.
* **Gaps are a warning.** If no range covers some scores, you'll see which. You can still save; a client who scores in the gap gets no suggested profile, and the adviser picks one.
* A range that runs backwards, has no From or To, or has no profile can't be saved.

When everything lines up you'll see **Every score 10–40 reaches exactly one profile.**

<figure><img src="https://3555949013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzoPnlIGiL5ejRdJEq5X%2Fuploads%2Fgit-blob-699cd7ebc5fc274d787bf4cf0df6442a9499393f%2Frisk-profiles-admin-scoring.png?alt=media" alt="Collins SBA&#x27;s questionnaire linked, with seven score ranges, one per profile"><figcaption><p>Collins SBA's questionnaire linked, with seven score ranges, one per profile</p></figcaption></figure>

{% hint style="info" %}
**Changing a range only affects questionnaires returned after you save.** Each risk profile keeps the score and the profile it was suggested at the time.
{% endhint %}

**Profiles that no range reaches are fine.** They're still available to advisers when agreeing a profile. A firm whose questionnaire only reaches four of its eight profiles uses this deliberately: the adviser chooses between the in-between profiles.

If a questionnaire you've linked still has ranges pointing at words that aren't your profiles (for example *Balanced* instead of *CSBA 4/7 Balance 50:50*), you'll see a warning. Pick a profile for each row and save.

## 4. Check what happens when a questionnaire comes back

The **When a form comes back** tab sets out what rubica does. It's the same for every firm; only your profiles, ranges and settings change it.

<figure><img src="https://3555949013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzoPnlIGiL5ejRdJEq5X%2Fuploads%2Fgit-blob-040a5680d0d718eb17c8e9ac2950d805580b39cc%2Frisk-profiles-admin-rules.png?alt=media" alt="When a form comes back: the questionnaire is On, and the review period is 3 years"><figcaption><p>When a form comes back: the questionnaire is On, and the review period is 3 years</p></figcaption></figure>

1. **A risk profile is created for the client.** It's saved on the person the questionnaire was sent for, or on the household if it was sent to the household. It holds the score, a link to the answers and the **suggested** profile. Each linked questionnaire shows here as **On**; **Turn off** stops new risk profiles being created. Ones already created are kept.
2. **The adviser agrees a profile.** The household shows the risk profile as **Pending Agreed Score** until the adviser agrees one. See [Agreeing a Client's Risk Profile](/households/risk-profiles/agreeing-a-risk-profile.md).
3. **It becomes the client's current profile.** Saving the agreed profile dates it (today, if no date is entered) and copies it to the client's **Risk profile** field. Only the client's most recent agreed risk profile does this, so correcting an old one never overwrites a newer profile.
4. **It comes due for review.** See below.
5. **Someone is told it's back.** Uses the questionnaire's own notifications. Set those up in the Form Builder under [When a Form Comes Back](/households/forms/when-a-form-comes-back.md). Collins SBA sends a bell notification to the household's owner.

## 5. Set your review period

On **When a form comes back**, step 4, set **Review after** to the number of years your firm reviews risk profiles (1 to 10), then click **Save**. Collins SBA uses **3**.

Once an agreed risk profile is older than that, its status changes from **Completed** to **Completed > 3 Years Ago** (with your number), and it shows that way on the household. It's a flag for the advice team; nothing is sent to the client automatically.

{% hint style="warning" %}
The review period drives the risk profile's **Status**. If your firm's risk profiles don't show a status yet, ask your rubica contact to switch it on.
{% endhint %}

## Changing things later

| You want to…                                  | Do this                                                                                                                                                                      |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Rename a profile or update its return figures | **Profiles** tab, open the profile, edit, save. Existing risk profiles keep the name they were agreed with.                                                                  |
| Add a profile                                 | **+ New profile**, then point a score range at it on **Questionnaire scoring** if the questionnaire should suggest it.                                                       |
| Retire a profile                              | Make it **Inactive**. Move any score range pointing at it to another profile.                                                                                                |
| Change the questions                          | Make a **new version of the form** in the Form Builder rather than editing the live one, then link the new version here. Editing a live form can hide answers already given. |
| Stop creating risk profiles from a form       | **When a form comes back**, **Turn off**.                                                                                                                                    |
