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

# Logo.dev core concepts

> The names for Logo.dev's brand assets, APIs, and keys in one place: company logo vs favicon, brandmark vs wordmark, monogram, social banner, and publishable vs secret key.

export const DocImage = ({src, alt, width, height}) => {
  const [base] = useState(() => typeof window !== "undefined" && window.location.pathname.startsWith("/docs") ? "/docs" : "");
  return <img alt={alt} height={height} src={`${base}${src}`} width={width} />;
};

The names for the things Logo.dev returns, and the APIs that return them. The brand-asset names trip people up the most, so they come with examples.

## Brand and visual terms

Everyone calls these things something different: icon, favicon, symbol, wordmark, brandmark, banner. Here is what each one actually is. A logo breaks into parts: a **symbol** (the graphic mark) and a **wordmark** (the styled name), which together make a **brandmark**.

### Company logo

<Frame>
  <img src="https://img.logo.dev/slack.com?token=live_6a1a28fd-6420-4492-aeb0-b297461d9de2" alt="Slack logo" width="96" height="96" />
</Frame>

A brand's actual mark at a resolution you can render anywhere. For most brands this is the **symbol** (also called the icon or mark): the graphic part with no text. It is what `img.logo.dev/:domain` returns. *Also called: logo, logomark, pictorial mark, icon, symbol, mark.*

### Brandmark

<Frame>
  <DocImage src="/docs/images/concepts/slack-brandmark.png" alt="Slack brandmark: the hash symbol next to the Slack wordmark" width="240" />
</Frame>

The wide, rectangular logo lockup: for most brands the symbol and wordmark together, and the wordmark alone for pure-type brands. The Brand API returns it in the `brandmark` field. Designers more often call this a combination mark, and many use brandmark to mean the symbol by itself. *Also called: combination mark, logo lockup, horizontal logo, full logo.*

### Wordmark

The styled text form of a company's name, with no symbol. It is the whole brandmark only for pure-type brands like Sony or Visa. *Also called: logotype, text logo.*

### Favicon

<Frame>
  <img src="https://img.logo.dev/slack.com?token=live_6a1a28fd-6420-4492-aeb0-b297461d9de2&size=32" alt="A favicon-sized Slack icon" width="32" height="32" />
</Frame>

The tiny icon a browser shows in a tab, usually 16 to 32 pixels. Logo.dev serves full-resolution company logos, not scraped favicons, though you can request a logo at favicon sizes. *Also called: site icon, tab icon, shortcut icon.*

### Monogram

<Frame>
  <DocImage src="/docs/images/concepts/monogram-example.png" alt="A generated monogram placeholder showing a single letter" width="96" height="96" />
</Frame>

A generated placeholder, a black-and-white mark with the domain's first letter, returned when Logo.dev has no logo for a domain so the image never breaks. *Also called: letter avatar, initials placeholder, fallback logo.*

### Social banner

<Frame>
  <DocImage src="/docs/images/concepts/slack-banner.png" alt="A Slack social-profile banner image" width="480" />
</Frame>

The wide header image a brand uses on its social profiles. The Brand API returns these in `social_banners`. *Also called: header image, cover image, OG banner.*

### Brand colors

The brand's prominent colors, roughly ordered by prominence, returned as hex values by the Brand API. *Also called: brand palette.*

## API terms

Logo.dev's APIs, by the job each does. For when to reach for which, see each product's overview.

* **Logo API.** Returns a company logo as an image from an `img.logo.dev` URL, by domain, ticker, ISIN, crypto symbol, or name. *Also called: the image API, logo image API.*
* **Search API.** Resolves a typed company name to its domain and logo, built for autocompletes. *Also called: brand search, autocomplete API.*
* **Brand API.** Returns a domain's full brand profile, adding the brandmark and social banners, on every plan and metered in credits. *Also called: brand profile API, brand kit.*
* **Transaction API.** Matches a raw card-transaction string to a merchant and its logo; in early access. *Also called: merchant enrichment, transaction enrichment.*

## Key terms

Logo.dev uses two kinds of key; which one you use follows from which API you call. Full detail on [API keys](/docs/platform/api-keys).

* **Publishable key.** A `pk_` key passed in the `token` query parameter on `img.logo.dev`, safe for client-side use. *Often miscalled a public key, public token, client key, or "the token"; the correct term is publishable key.*
* **Secret key.** An `sk_` key sent in the `Authorization: Bearer` header to `api.logo.dev`, server-side only. *Often miscalled a private key, server key, or generic "API key"; the correct term is secret key.*
* **Domain restrictions.** A per-key setting (the **Allowed Domains Only** toggle) that limits a publishable key to requests from domains you list. *Also called: allowed domains, referrer restrictions.*

## Next steps

<CardGroup cols={3}>
  <Card title="Rate limits" icon="gauge-high" href="/docs/platform/rate-limits">
    Free plans stop at the cap; paid plans keep running and get nudged. What counts as a request.
  </Card>

  <Card title="Attribution" icon="link" href="/docs/platform/attribution">
    On the free plan, commercial use needs a Logo.dev link; personal and paid use don't.
  </Card>

  <Card title="Pricing" icon="tag" href="https://www.logo.dev/pricing">
    Plans and what each tier includes.
  </Card>
</CardGroup>