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

---
id: 0e8be2d8-7dc5-47a2-8749-eee2447c5d86
---

# Illustration

> Learn about the Illustration component for use in UI extensions.

The `Illustration` component renders an illustration from HubSpot's illustration library. Use this component to add a visual indicator to your app card.

<Frame>
  <img src="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-component-example-illustration.png" alt="Example showing an app card that uses the 'lock' illustration" />
</Frame>

```jsx theme={null}
import { Illustration } from "@hubspot/ui-extensions";

const Extension = () => {
  return (
    <Illustration
      name="lock"
      alt="Lock icon indicating content is currently restricted or inaccessible"
      width={300}
      height={300}
    />
  );
};
```

## Props

| Prop     | Type   | Description                                                                            |
| -------- | ------ | -------------------------------------------------------------------------------------- |
| `alt`    | String | The illustration's alt text for accessibility. Default value is `<name> illustration`. |
| `height` | Number | The height of the illustration in pixels.                                              |
| `name`   | String | The name of the illustration. See [available illustrations](#available-illustrations). |
| `width`  | Number | The width of the illustration in pixels.                                               |

## Available illustrations

<div className="card-grid illustrations-grid">
  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/add-on-reporting.png">
    `addOnReporting`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/api.png">
    `api`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/automated-testing.png">
    `automatedTesting`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/calling-set-up.png">
    `callingSetUp`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/companies.png">
    `companies`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/contacts.png">
    `contacts`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/content-strategy.png">
    `contentStrategy`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/custom-objects.png">
    `customObjects`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/customer-experience.png">
    `customerExperience`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/customer-support.png">
    `customerSupport`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/deals.png">
    `deals`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/developer-security-update.png">
    `developerSecurityUpdate`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/electronic-signature.png">
    `electronicSignature`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/electronic-signature-empty-state.png">
    `electronicSignatureEmptyState`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/email-confirmation.png">
    `emailConfirmation`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/empty-state-charts.png">
    `emptyStateCharts`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/error-general.png">
    `errorGeneral`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/error-hourglass.png">
    `errorHourglass`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/integrations.png">
    `integrations`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/leads.png">
    `leads`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/lock.png">
    `lock`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/meetings.png">
    `meetings`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/middle-pane-cards.png">
    `middlePaneCards`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/multiple-objects.png">
    `multipleObjects`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/object.png">
    `object`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/payments-button.png">
    `paymentsButton`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/products-shopping-cart.png">
    `productsShoppingCart`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/properties-sidebar.png">
    `propertiesSidebar`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/registration.png">
    `registration`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/sandbox-add-on.png">
    `sandboxAddOn`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/settings-sidebar.png">
    `sidebar`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/social.png">
    `social`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/store.png">
    `store`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/store-disabled.png">
    `storeDisabled`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/successfully-connected-email.png">
    `successfullyConnectedEmail`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/target.png">
    `target`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/task.png">
    `task`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/tickets.png">
    `tickets`
  </Card>

  <Card img="https://developers.hubspot.com/hubfs/Knowledge_Base_2023-24-25/uie-illustrations/unlock.png">
    `unlock`
  </Card>
</div>

## Related components

* [Icon](/apps/developer-platform/add-features/ui-extensions/ui-components/standard-components/icon)
* [EmptyState](/apps/developer-platform/add-features/ui-extensions/ui-components/standard-components/empty-state)
* [ErrorState](/apps/developer-platform/add-features/ui-extensions/ui-components/standard-components/error-state)
