> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding custom data to your apps

## After this article...

You'll know how to add custom data to your apps in Lumos so you can better understand what licenses or entitlements your employees have.

## Background

You can enrich app data in Lumos with columns that you download directly from the service outside of Lumos (e.g. roles or permissions). Use this when the default columns from a Lumos integration or your IdP (e.g. Okta) aren't enough for an Access Review, or when you need to refresh the data for a **custom app** before an audit. *See*[Adding a custom app](/kb/identities/custom-apps/adding-a-custom-app)

## Before you start

* Your CSV needs an Email, or a First Name and Last Name, for every row. See [Custom Data (CSV) Formatting Requirements](/kb/identities/custom-apps/custom-data-csv-formatting-requirements).
* Lumos matches each row to existing accounts using the app's Identity Matching rules. Read [Updating custom data for existing accounts](#updating-custom-data-for-existing-accounts) before you import.
* Lumos treats your CSV as the current state of the app's manually uploaded accounts, so any account that isn't in your CSV is marked Deprovisioned, unless another source, such as your IdP or an integration, reports a different status for it.

## Steps

As an example, this article updates Google Workspace in Lumos to include a custom column, "Hogwarts House".

### 1. Go to the [All Apps page](https://app.lumosidentity.com/apps?tab=apps) and open the app you want to update.

### 2. Click **Download Table (CSV)** to back up the app's current accounts.

Keep this file in case the import doesn't work as expected.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/lumos-primary/images/kb/identities/custom-apps/adding-custom-data-to-your-apps/6c06dea167b9-a84855c7-648f-4a4a-b3b3-115b7fbfa78d2F1759854910850-Screensh.png" alt="The Download Table (CSV) button next to Import Accounts on an app's Accounts tab" />
</Frame>

### 3. Click **Import Accounts** in the top right, which will prompt you to upload a CSV.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/lumos-primary/images/kb/identities/custom-apps/adding-custom-data-to-your-apps/0d68f71284d7-a50e2741-9673-4358-9f0a-7ff2814179582F1727892732570-.jpg" alt="googleworkspace.jpg" />
</Frame>

More information on the validations for uploaded files can be found here:[Custom Data (CSV) Formatting Requirements](/kb/identities/custom-apps/custom-data-csv-formatting-requirements)

### 4. After attaching a file, you'll be prompted to map any additional fields.

In this example, this is “Hogwarts House”.

The name of the field on the right is what will show up in Lumos, while the name of the field on the left is the column header of your CSV.

<video controls className="w-full aspect-video" src="https://mintlify.s3.us-west-1.amazonaws.com/lumos-primary/images/kb/identities/custom-apps/adding-custom-data-to-your-apps/40d5b6d60021-a50e2741-9673-4358-9f0a-7ff2814179582F1727892733086-.mp4" />

### 5. Select “Preview Table”, which will take you to a preview of the data.

If the upload fails, make sure the mapping follows the Lumos formatting requirements. *See*[Custom Data (CSV) Formatting Requirements](/kb/identities/custom-apps/custom-data-csv-formatting-requirements)

### 6. If you're happy with the data, click "Finish Import". Otherwise, go back to step 4 and update the mappings.

You’ll see the “Source” column is updated for rows that matched to existing accounts with an additional “Manual” icon (the silhouette of a person).

## Updating custom data for existing accounts

When uploading a CSV of custom account data, existing user's accounts will be matched on the Identity Matching rules in the app's Integrations tab:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/lumos-primary/images/kb/identities/custom-apps/adding-custom-data-to-your-apps/17311d1b8550-a84855c7-648f-4a4a-b3b3-115b7fbfa78d2F1770769106824-Screensh.png" alt="Screenshot 38.png" />
</Frame>

"Unique ID" in the upload will become the "Stable Identifier" in Lumos:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/lumos-primary/images/kb/identities/custom-apps/adding-custom-data-to-your-apps/1f0d9e0dff8f-a84855c7-648f-4a4a-b3b3-115b7fbfa78d2F1759854768400-Screensh.png" alt="Screenshot 53.png" />
</Frame>

If an existing account has only a "Manual" Source, and it is **not listed** in the CSV upload:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/lumos-primary/images/kb/identities/custom-apps/adding-custom-data-to-your-apps/1c66133ae1d1-a84855c7-648f-4a4a-b3b3-115b7fbfa78d2F1759854918807-Screensh.png" alt="Screenshot_2025-05-21_at_8_19_48 AM.png" />
</Frame>

the account will become "Deprovisioned":

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/lumos-primary/images/kb/identities/custom-apps/adding-custom-data-to-your-apps/97fbb4529d01-a84855c7-648f-4a4a-b3b3-115b7fbfa78d2F1759854941248-Screensh.png" alt="Screenshot_2025-05-20_at_6_07_20 PM.png" />
</Frame>

For a custom app, imported accounts can take up to 15 minutes to populate or update. If the results aren't what you expected, contact [support@lumos.com](mailto:support@lumos.com).