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

# Get Logos from a Domain

> Embed any company logo in your app with Logo Link — a fast, cached CDN endpoint that returns a logo image for any domain you request.

Logo Link is a Context.dev service that provides fast, reliable logo delivery via a global CDN.

Pass a `publicClientId` and a `domain` to the Logo Link URL and use it as your `<img>` source URL.

<Info>
  Logo Link is designed for direct image embedding. Do not download, persist, or rehost the image files. Normal browser/CDN caching directed by the response headers is allowed.
</Info>

<Prompt description="Integrate Context.dev's Logo Link in your app" icon="sparkles" actions={["copy", "cursor"]}>
  I'm integrating Context.dev's Logo Link into my app to dynamically fetch and display company logos by domain. Help me:

  1. Ask where in my codebase I want to display company logos.
  2. Ask me for my Logo Link `publicClientId` from [https://context.dev/dashboard/logolink](https://context.dev/dashboard/logolink). Read it from an environment variable if the codebase supports one.
  3. Implement Logo Link using this URL format: `https://logos.context.dev/?publicClientId=MY_PUBLIC_CLIENT_ID&domain=TARGET_DOMAIN`. Replace `MY_PUBLIC_CLIENT_ID` with the ID I provide and `TARGET_DOMAIN` with the company domain variable. Optionally add `theme=light` or `theme=dark` to request the best logo for a light or dark themed application, and `type=wordmark` for a wordmark at least 1.5:1 (or omit / use `type=icon` for a square icon). The endpoint returns an image file directly.
  4. Update only the identified code locations that currently handle logo display, preserving existing fallback and error handling patterns.
  5. Remind me to restrict allowed referring domains at [https://context.dev/dashboard/logolink](https://context.dev/dashboard/logolink) so strangers can't charge my account.

  Docs: [https://docs.context.dev/guides/get-logo-from-url](https://docs.context.dev/guides/get-logo-from-url)
</Prompt>

## Prerequisites

<Steps>
  <Step title="Sign up">
    Create an account at [context.dev/signup](https://context.dev/signup). The free tier includes 10,000 one-time Logo Link credits, no credit card required.

    <img src="https://mintcdn.com/branddev/repamerS-LSYfOs8/images/signup.png?fit=max&auto=format&n=repamerS-LSYfOs8&q=85&s=f40a86a0defa754278e9d32f118c4050" alt="Context.dev signup page" width="2784" height="1776" data-path="images/signup.png" />
  </Step>

  <Step title="Get your Public Client ID">
    Go to the [Logo Link dashboard](https://context.dev/dashboard/logolink) and copy the key from the "Public Client ID" section.

    <img src="https://mintcdn.com/branddev/repamerS-LSYfOs8/images/logolink-page.png?fit=max&auto=format&n=repamerS-LSYfOs8&q=85&s=c2fa8a9bb11f94fd18f3562067a2bc8f" alt="Logo Link dashboard showing Public Client ID and Domain Restrictions" width="3122" height="2030" data-path="images/logolink-page.png" />

    <Info>
      This `publicClientId` is safe to expose in your frontend, because it can only be called by the domains you have explicitly allowed.
    </Info>
  </Step>

  <Step title="Important: Set Domain Restrictions">
    Click on <kbd>Edit Restrictions</kbd> and add your website domain where the image will be embedded:

    * `*.example.com`
    * `localhost:3000`

    <Frame>
      <img src="https://mintcdn.com/branddev/repamerS-LSYfOs8/images/domain-restrictions.png?fit=max&auto=format&n=repamerS-LSYfOs8&q=85&s=fa4fb96a65fa9c9ad0a164d429689fe7" alt="Logo Link dashboard showing Public Client ID and Domain Restrictions" width="1969" height="1021" data-path="images/domain-restrictions.png" />
    </Frame>
  </Step>
</Steps>

## Build the URL

Replace `publicClientId` and `domain` in the Base URL and set it as the image source. You can also add a `theme` parameter to request the best logo for a light or dark themed application, and a `type` parameter to choose a square icon or a wordmark at least 1.5:1:

```text theme={null}
https://logos.context.dev/?publicClientId=brandLL_xxx&domain=github.com
```

### Parameters

| Parameter        | Required | Description                                                                                                                                                                                                                                |
| ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `publicClientId` | Yes      | Your frontend-safe Logo Link client ID.                                                                                                                                                                                                    |
| `domain`         | Yes      | The domain to fetch a logo for, such as `github.com`.                                                                                                                                                                                      |
| `theme`          | No       | Not set: displays the highest resolution logo available for the selected type.<br />`light`: displays a dark logo for light themed applications (light mode).<br />`dark`: displays a light logo for dark themed applications (dark mode). |
| `type`           | No       | Not set / `icon`: prefers a near-square logo (icon).<br />`wordmark`: prefers a logo at least 1.5:1 (or 1:1.5).                                                                                                                            |

<Info>
  Logo Link accepts only `GET` and `HEAD` requests.
</Info>

### Response

The body is the raw logo bytes; there is no JSON envelope. Point an `<img>` tag at the URL and the browser renders it. Fetch it with code and you get a binary blob.

| Header          | Value                                                                                |
| --------------- | ------------------------------------------------------------------------------------ |
| `Content-Type`  | The actual media type of the image: `image/png`, `image/svg+xml`, `image/jpeg`, etc. |
| `Cache-Control` | Follow the caching policy returned by the Logo Link service.                         |

## Pricing

Logo Link usage is billed separately from the core Context.dev APIs. Logo Link requests **do not** consume API credits or the core API RPM budget. Paid plans include a recurring Logo Link pool; Free includes a one-time grant:

| Plan                  | API credits     | Logo Link credits |
| --------------------- | --------------- | ----------------- |
| Free — personal email | 250 one-time    | 10,000 one-time   |
| Free — work email     | 500 one-time    | 10,000 one-time   |
| Developer (\$25)      | 10,000/month    | 100,000/month     |
| Pro (\$149)           | 200,000/month   | 2,500,000/month   |
| Scale (\$499)         | 1,000,000/month | 10,000,000/month  |
| Enterprise            | Custom          | Custom            |

See [pricing](https://context.dev/pricing/) for details.

Logo Link image delivery is separate from core API rate limits. Track the applicable Logo Link quota and current usage in the [Logo Link dashboard](https://context.dev/dashboard/logolink); current service-level throttling or fair-use rules are governed by the Logo Link service terms. Browser/CDN caching directed by its response headers is expected and allowed. See [Usage Restrictions](#usage-restrictions) for what is not.

## Embed the image

Drop the URL into any place that accepts an image source: `<img>`, CSS `background-image`, an email template, a spreadsheet `=IMAGE()` cell.

<Tabs>
  <Tab title="HTML">
    ```html theme={null}
    <img
      src="https://logos.context.dev/?publicClientId=brandLL_xxx&domain=stripe.com"
      alt="Stripe logo"
    />
    ```
  </Tab>

  <Tab title="CSS background">
    ```css theme={null}
    .company-card {
      background-image: url("https://logos.context.dev/?publicClientId=brandLL_xxx&domain=stripe.com");
      background-size: contain;
      background-repeat: no-repeat;
    }
    ```
  </Tab>

  <Tab title="React">
    ```jsx theme={null}
    function CompanyLogo({ domain }) {
      const publicClientId = process.env.NEXT_PUBLIC_LOGOLINK_KEY;

      return (
        <img
          src={`https://logos.context.dev/?publicClientId=${publicClientId}&domain=${domain}`}
          alt={`${domain} logo`}
          onError={(e) => {
            e.target.style.display = "none";
          }}
        />
      );
    }
    ```
  </Tab>

  <Tab title="JavaScript fetch">
    ```javascript theme={null}
    const response = await fetch(
      "https://logos.context.dev/?publicClientId=brandLL_xxx&domain=github.com",
    );

    if (response.ok) {
      const blob = await response.blob();
      const imageUrl = URL.createObjectURL(blob);
      document.getElementById("logo").src = imageUrl;
    }
    ```
  </Tab>

  <Tab title="Email HTML">
    ```html theme={null}
    <img
      src="https://logos.context.dev/?publicClientId=brandLL_xxx&domain=stripe.com"
      alt="Stripe"
      width="48"
      height="48"
      style="border-radius:8px;"
    />
    ```
  </Tab>

  <Tab title="Sheets / Excel">
    ```text theme={null}
    =IMAGE("https://logos.context.dev/?publicClientId=brandLL_xxx&domain=" & A2)
    ```

    See the [Google Sheets](/nocode/google-sheets) and [Microsoft Excel](/nocode/microsoft-excel) recipes.
  </Tab>
</Tabs>

<Note>
  Handle image-load errors in your UI with an initials, icon, or hidden-image fallback. Do not assume every unknown or unavailable domain will return a usable image.
</Note>

## Usage Restrictions

Logo Link is intentionally ephemeral, fast and image-only. **You are not allowed to download and re-host logos retrieved from Logo Link, or persist the image files in your own storage.** (Normal browser and CDN caching driven by the response's `Cache-Control` headers is fine.)

Use Context.dev's [Brand APIs](/guides/get-brand-data) if you:

* Need to store brand-response metadata or media URLs under the Brand API terms
* Get multiple logo variants (light / dark / opaque background, icon vs wordmark)
* Or, pull logo colors and other brand details alongside the logo

Need the brand's fonts too? Those come from the [Styleguide and Fonts APIs](/guides/extract-design-system-from-website).

## Use cases

Logo Link is purpose-built for client-facing embeds where you'd otherwise have to host logo assets yourself:

* **CRM & Sales Platforms**: Drop a Logo Link URL into every contact record.
* **Customer Logo Walls**: Use users' sign-up email domains to automatically generate "trusted by" strips on landing pages.
* **Financial & Banking Apps**: Render merchant logos next to transaction descriptors.
* **Directories & Marketplaces**: Populate listings with logos automatically, with no upload step in vendor onboarding.

## Next steps

<CardGroup cols={2}>
  <Card title="Full Brand Profile" icon="palette" href="/guides/get-brand-data">
    Logos, colors, socials, address, and industry from one call.
  </Card>

  <Card title="Google Sheets Recipe" icon="table" href="/nocode/google-sheets">
    `=IMAGE()` formula patterns for logo columns at scale.
  </Card>

  <Card title="Best Practices" icon="list-check" href="/optimization/best-practices">
    Caching, error handling, and key hygiene.
  </Card>

  <Card title="Troubleshooting" icon="bug" href="/optimization/troubleshooting">
    Status codes, retry patterns, and common errors.
  </Card>
</CardGroup>