---
title: Clean up brands and competitors
description: Inspect missing brands, duplicates, domains, and aliases, then
  verify approved changes.
canonical_url: https://orchestor.io/docs/en/cli/workflows/brand-setup
markdown_url: https://orchestor.io/docs/en/cli/workflows/brand-setup.md
contentType: how-to
---

# Clean up brands and competitors

Inspect missing brands, duplicates, domains, and aliases, then verify approved changes.

## When to use this workflow

> “The same brand appears under different names; clean up the competitor setup too.”

## Before fetching

Confirm canonical names, official domains, and owned-versus-competitor relations. Distinguish spelling variants from different companies; names alone do not establish identity.

Complete the [CLI quickstart](https://orchestor.io/docs/cli/quickstart.md) and confirm the workspace with `orc workspace current --json`. Replace example IDs, URLs, dates, and settings. Apply only approved mutations.

## 1. Compare configured brands and suggestions

If this workspace has no brands yet, create your owned brand first. Replace the name and domain with the actual target, then use the returned ID as `YOUR_BRAND_ID`. Registering a brand alone does not start prompt measurement.

```bash
orc brands create --workspace WORKSPACE_ID --name 'YOUR_BRAND_NAME' --domain 'YOUR_OFFICIAL_DOMAIN' --relation owned --json
orc brands get YOUR_BRAND_ID --workspace WORKSPACE_ID --json
```

The default list contains owned brands and direct competitors. Specify relation to inspect indirect or ignored brands as needed. Cross-check unconfigured brands found in answers with suggestions.

```bash
orc brands list --json
orc brands list --relation indirect_competitor --json
orc brands suggestions list --json
orc brands get YOUR_BRAND_ID --json
```

## 2. Apply the approved correction

Pass the complete alias set, retaining existing aliases. Apply the approved domain and display color, then read the same ID back. This update does not merge duplicate histories.

```bash
orc brands update YOUR_BRAND_ID --domain 'example.com' --aliases 'YOUR_EXISTING_ALIAS,YOUR_APPROVED_ALIAS' --color-hex '#2563eb' --json
orc brands get YOUR_BRAND_ID --json
```

## Deliverable

Deliver before-and-after fields and brand IDs, unresolved duplicate candidates, and names to check in subsequent observations.

On fetch failure, retain the error and request scope. Do not count empty data, incomplete pagination, or missing permissions as a completed investigation.

## Next steps

[Workflow index](https://orchestor.io/docs/cli/workflows.md) · [Clean up topics and tags](https://orchestor.io/docs/cli/workflows/taxonomy-audit.md) · [Check consistency across owned surfaces](https://orchestor.io/docs/cli/workflows/entity-consistency.md)

If a failure remains, [report it and verify the fix](https://orchestor.io/docs/cli/workflows/workflow-feedback.md), including this workflow and the failed step.

---

[Documentation index](https://orchestor.io/docs/llms.txt)