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

# Artists

> Manage artists, performers, and creators in your CRM

## Overview

Artists represent the individuals who create and perform music. This includes recording artists, songwriters, composers, and producers. Artists can be linked to recordings, compositions, and contracts.

## Artist Information

### Core Fields

| Field           | Description            | Required |
| --------------- | ---------------------- | -------- |
| **Name**        | Artist/stage name      | Yes      |
| **Legal Name**  | Real legal name        | No       |
| **Aliases**     | Other names/pseudonyms | No       |
| **Nationality** | Country of citizenship | No       |

### Identifiers

| Field              | Description                            |
| ------------------ | -------------------------------------- |
| **IPI**            | Interested Party Information number    |
| **IPN**            | Interested Party Number                |
| **ISNI**           | International Standard Name Identifier |
| **Spotify ID**     | Spotify artist identifier              |
| **Apple Music ID** | Apple Music artist identifier          |

### Professional Info

| Field               | Description                     |
| ------------------- | ------------------------------- |
| **Role**            | Artist, writer, producer, etc.  |
| **PRO Affiliation** | Performance rights organization |
| **Publisher**       | Primary publisher               |
| **Management**      | Management company              |

## Viewing Artists

### List View

The artists list shows:

* Artist name and image
* Key identifiers
* Associated entities (labels, publishers)
* Recording/composition counts

### Filters

Filter artists by:

* **Role** - Artist, writer, producer
* **PRO** - PRO affiliation
* **Label** - Associated record label
* **Publisher** - Associated publisher
* **Status** - Active, inactive

### Search

Search artists by:

* Name (stage or legal)
* Aliases
* Identifiers (IPI, Spotify ID, etc.)

## Artist Detail View

Click on any artist to see full details:

### Banner Section

* Artist name and image
* Key stats at a glance
* Quick action buttons

### Tabs

<Tabs>
  <Tab title="Details">
    A single scrollable page that brings together everything about the artist. Use the section navigation on the left to jump between sections (or the dropdown on smaller screens):

    | Section              | What it shows                                                                                |
    | -------------------- | -------------------------------------------------------------------------------------------- |
    | **Artist**           | Core artist information including names, identifiers, and professional details.              |
    | **Artist Entities**  | Labels, publishers, and other companies this artist has worked with throughout their career. |
    | **Artist Contracts** | Contracts where this artist appears.                                                         |
  </Tab>

  <Tab title="Timeline">
    AI-generated chronological view of all agreements involving this artist. See [Agreement Timeline](/projects/crm/agreement-timeline) for details.
  </Tab>
</Tabs>

<Tip>
  Click the **pin** icon next to any section in the Details navigation to keep it at the top of the page. Pinned sections are remembered the next time you open an artist.
</Tip>

## Adding Artists

### From Contract Extraction

Artists are automatically added when contracts mention them:

1. Upload a recording or publishing contract
2. AI extracts artist names
3. Artists are matched or created
4. Review and verify details

### Manual Entry

<Steps>
  <Step title="Go to CRM">
    Navigate to **CRM** → **Artists**.
  </Step>

  <Step title="Click Add">
    Click **Add Artist**.
  </Step>

  <Step title="Enter Details">
    Fill in name, identifiers, and professional information.
  </Step>

  <Step title="Add Profile Image">
    Upload or fetch artist image.
  </Step>

  <Step title="Save">
    Artist is added to your CRM.
  </Step>
</Steps>

### From DSP Enrichment

Import artist data from streaming platforms:

<Steps>
  <Step title="Enable Integration">
    Connect Spotify or Apple Music in Settings.
  </Step>

  <Step title="Search DSP">
    Search for the artist on the platform.
  </Step>

  <Step title="Import Data">
    Import profile data, images, and identifiers.
  </Step>
</Steps>

## Editing Artists

<Steps>
  <Step title="Open Artist">
    Navigate to the artist detail view.
  </Step>

  <Step title="Click Edit">
    Click **Edit** or click individual fields.
  </Step>

  <Step title="Make Changes">
    Update artist information.
  </Step>

  <Step title="Save">
    Changes are saved with full history tracking.
  </Step>
</Steps>

## Artist-Entity Connections

### Linking to Labels

<Steps>
  <Step title="Open Artist">
    Navigate to the artist.
  </Step>

  <Step title="Go to the Artist Entities section">
    On the **Details** tab, open the **Artist Entities** section from the section navigation.
  </Step>

  <Step title="Add Connection">
    Click **Add** and search for the label.
  </Step>

  <Step title="Define Relationship">
    Specify the relationship type (signed artist, distributed by, etc.).
  </Step>
</Steps>

### Linking to Publishers

<Steps>
  <Step title="Open Artist">
    Navigate to the artist.
  </Step>

  <Step title="Go to the Artist Entities section">
    On the **Details** tab, open the **Artist Entities** section from the section navigation.
  </Step>

  <Step title="Add Publisher">
    Click **Add** and search for the publisher.
  </Step>

  <Step title="Specify Role">
    Indicate writer share and territory coverage.
  </Step>
</Steps>

## Smart Linking & Deduplication

### Automatic Matching

When contracts are processed, artists are automatically matched using:

1. **Exact Name Match** - Direct name comparison
2. **Identifier Match** - Spotify ID, Apple Music ID, IPI, etc.
3. **AI Semantic Matching** - Fuzzy matching for name variations

### AI-Powered Deduplication

When a potential duplicate is detected, the AI evaluates:

* Name similarity and variations
* Identifier overlap
* Associated entity relationships

The system automatically merges duplicates when confident, preserving all data from both records.

### Viewing Merge Reasoning

When artists are automatically merged, you can view the AI's reasoning:

<Steps>
  <Step title="Open Parent Artist">
    Navigate to the primary artist record.
  </Step>

  <Step title="Go to Artist Links">
    Scroll to the Artist Links section to see merged records.
  </Step>

  <Step title="View Reasoning">
    Hover over the lightbulb icon next to any merged artist to see why the AI determined they were the same person.
  </Step>
</Steps>

<Note>
  When clicking on a merged artist from anywhere in the platform, you'll be automatically redirected to the parent (primary) artist record.
</Note>

## Manual Merging

When you find duplicate artists that weren't automatically merged:

<Steps>
  <Step title="Identify Duplicates">
    Find artist records that represent the same person.
  </Step>

  <Step title="Select Primary">
    Choose which record should be kept.
  </Step>

  <Step title="Initiate Merge">
    Use the **Merge Artists** dialog.
  </Step>

  <Step title="Review & Confirm">
    Review the merge preview and confirm.
  </Step>
</Steps>

### Unmerging Artists

If artists were incorrectly merged:

<Steps>
  <Step title="Open Parent Artist">
    Navigate to the primary artist record.
  </Step>

  <Step title="Go to Artist Links">
    View the merged artist records.
  </Step>

  <Step title="Click Unmerge">
    Click **Unmerge** next to the incorrectly merged record.
  </Step>

  <Step title="Confirm">
    The artist becomes independent again.
  </Step>
</Steps>

## Artist Analytics

### Career Overview

* Total recordings
* Total compositions
* Release timeline
* Revenue summary

### Entity Relationships

An artist may be linked to multiple entities because their career spans different business relationships over time:

* **Different labels** — An artist might sign with one label early in their career, then move to another
* **Multiple publishers** — Different compositions may be administered by different publishers
* **Various roles** — The same artist might have recording deals, publishing deals, and production agreements with different companies

These relationships come from the contracts in your system. Each contract where an artist appears creates or confirms an entity relationship. The **Timeline** tab shows these relationships chronologically; see [Agreement Timeline](/projects/crm/agreement-timeline) for details and how it differs from [IP Groups](/projects/contracts/ip-groups).

## Roles and Credits

Artists can have multiple roles:

| Role                | Description                         |
| ------------------- | ----------------------------------- |
| **Primary Artist**  | Main performing artist on recording |
| **Featured Artist** | Featured guest on recording         |
| **Writer**          | Songwriter or composer              |
| **Producer**        | Record producer                     |
| **Mixer**           | Mixing engineer                     |
| **Remixer**         | Remix artist                        |

### Adding Credits

<Steps>
  <Step title="Open Recording/Composition">
    Navigate to the catalog item.
  </Step>

  <Step title="Add Credit">
    Add the artist with their specific role.
  </Step>

  <Step title="Link to Artist">
    Connect to the artist's CRM record.
  </Step>
</Steps>

## PRO Information

### PRO Fields

| Field            | Description                                        |
| ---------------- | -------------------------------------------------- |
| **PRO**          | Performance rights organization (ASCAP, BMI, etc.) |
| **CAE/IPI**      | CAE/IPI number                                     |
| **Member Since** | PRO membership date                                |
| **Territory**    | PRO territory coverage                             |

### Multiple PROs

Artists may be affiliated with different PROs in different territories:

```
Writer: John Smith
├── US: ASCAP (IPI: 123456789)
├── UK: PRS (IPI: 987654321)
└── EU: Sub-published by Publisher X
```

## Best Practices

<AccordionGroup>
  <Accordion title="Use consistent names">
    Use the most common/official artist name as primary.
  </Accordion>

  <Accordion title="Add all aliases">
    Include stage names, real names, and project names.
  </Accordion>

  <Accordion title="Include identifiers">
    Add IPI, Spotify ID, and other identifiers for better matching.
  </Accordion>

  <Accordion title="Link to entities">
    Connect artists to their labels, publishers, and management.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Writers" icon="pen" href="/projects/crm/writers">
    Learn about managing songwriters and composers.
  </Card>

  <Card title="Relations" icon="diagram-project" href="/projects/crm/relations">
    Learn about defining relationships between entities.
  </Card>
</CardGroup>