# Subscribers

A subscriber is a company represented in the list so you can identify it and review the plan
assigned to it. Use the list to find a company, review its assigned plan, and open subscriber
details when you need to review or change that plan.

| If you need to… | Go to |
| --- | --- |
| Identify a company and read its assigned plan | [Understand the subscriber list](#understand-the-subscriber-list) |
| Narrow the list to a company | [Filter and review the list](#filter-and-review-the-list) |
| Open a company's subscriber details | [Find a subscriber](#find-a-subscriber) |
| Review or change the company's assigned plan | [Subscriber details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscriber-edit-record) |
| Review plan definitions | [Plans](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans) |
| Administer features separately from subscribers | [Features](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features) |

## Subscribers

A subscriber is a company represented in the list so you can identify that company and review the
plan assigned to it. The list is the entry point for reviewing or changing one company's assigned
plan.

| Field | What it tells you | How you use it |
| --- | --- | --- |
| **Company** | The subscriber company. | Identify the company row to review. |
| **Sub Domain** | The subscriber's subdomain. | Distinguish the subscriber entry you are reviewing. |
| **Plan** | The plan assigned to the company. | Review the company's current plan before opening its details. |

The list supports company-level review. It does not replace the subscriber details page for work
on one company's assigned plan, and it does not replace the separate pages for plan definitions or
feature administration.

## Before you start

Know the company whose assigned plan you need to review. The list contains row edit links as well
as data-row selection behavior, so identify the company from **Company** before using an edit entry.
Do not select an edit link when you cannot tell which row it belongs to.

When you are ready, use the three visible columns to identify the company.

## Understand the subscriber list

The subscriber list is a read-only grid for reviewing three subscriber values. Each visible column
can be filtered, but the grid does not edit these values.

| Visible column | Use it to | Grid behavior |
| --- | --- | --- |
| **Company** | Identify the subscriber company. | Visible, filterable, and not editable in the grid. |
| **Sub Domain** | Review the subscriber's subdomain. | Visible, filterable, and not editable in the grid. |
| **Plan** | Review the plan assigned to the company. | Visible, filterable, and not editable in the grid. |

The column chooser is disabled, so work from these three headers. To open a company after you
identify it, continue with [Find a subscriber](#find-a-subscriber).

## Find a subscriber

Open a company's subscriber details as follows.

**Prerequisites**

- Know the company whose assigned plan you need to review.
- Be ready to identify that company in the **Company** column.

**Steps**

1. Open **Configuration**.
2. Open the subscriber list.
3. Locate the company in the **Company** column.
4. Identify the matching subscriber row.
5. Select a data-row cell in the matching subscriber row.

The row edit entry is also built from the row's company identifier. Use it only when the entry is
unambiguously associated with the company row you identified.

![Locate the company row before opening subscriber details.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/302f65ff903bfc8bdeda2b8eff61f3da.png)

**Result:** The selected subscriber row is ready to continue to subscriber details.

After the list opens, use the **Filter Row** when the company is difficult to locate.

## Filter and review the list

Filtering is remote, so apply the filter before selecting the company row you need.

**Prerequisites**

- Open the subscriber list.
- Know the company name or another value that narrows the list.

**Steps**

1. In the **Filter Row**, enter the value that identifies the company.
2. Apply the filter from the **Filter Row**.
3. Review the matching **Company**, **Sub Domain**, and **Plan** values.
4. Select the matching subscriber row.

Pressing Enter in the filter interaction invokes the grid filter application routine. Filtering also
applies when you use the filter's click action. Review the company row after the list refreshes so
that you open the intended subscriber.

**Result:** The list shows the filtered subscriber rows, and the matching company row is identified
for review or continuation to subscriber details.

If the list does not behave as expected, use the supported action in the following table.

## When list review goes wrong

| What you see | What it means | What to do |
| --- | --- | --- |
| `An error occurred while processing your request` | The subscriber list could not complete its request. | Reload the list and review it again. |
| No delete option is available | The subscriber list does not provide a delete menu. | Review the row or continue to subscriber details. |
| No column chooser is available | The column chooser is disabled for this list. | Use the visible **Company**, **Sub Domain**, and **Plan** columns. |
| No search panel is visible | Search-panel controls are not part of this list view. | Use the **Filter Row**. |
| No paging controls are visible | Paging is disabled for this list. | Review the loaded rows and use the **Filter Row** to narrow them. |
| Filtering does not narrow the list | The filter needs to be applied again. | Apply the **Filter Row** again. |

**Prerequisites**

- The subscriber list is open.

**Steps**

1. Match what you see to the table, then perform the action in its What to do column.

**Result:** You have a supported list-review action and can continue by identifying the company row.

## Know what is next

After you identify a company, subscriber details is the next place to review or change its assigned
plan. The subscriber list remains the place to identify the company and review the plan shown in the
row.

| Need | Continue at |
| --- | --- |
| Review or change one company's assigned plan | [Subscriber details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscriber-edit-record) |
| Review plan definitions and the plan-definition entry point | [Plans](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans) |
| Administer features separately | [Features](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features) |

Selecting a subscriber row opens subscriber details. Plan assignment belongs on subscriber details;
plan definitions and feature administration belong on their separate configuration pages.
