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

# White-label

> Customize the invitation experience with your brand colors, logo, and company name.

<Tip>
  Need help in this area? See [Premium FAQ](/platform/premium/faq).
</Tip>

If you send [invitations](/platform/data-input/invitations) to your clients, you probably want those pages to look like they come from **your** company, not from Nectar. White-label lets you customize the invitation interface with your own branding, so your clients see your logo, your colors, and your company name. Any outstanding legacy magic links automatically pick up the same branding.

## What white-label changes

White-labeling affects the **invitation experience** — the page your clients see when they click an invitation to connect their utility accounts.

| Element           | What you can customize                                                            |
| ----------------- | --------------------------------------------------------------------------------- |
| **Header text**   | Your company name appears at the top of the page instead of Nectar's name         |
| **Button colors** | Buttons and accent elements use your brand color instead of Nectar's default blue |
| **Logo**          | Your company logo is displayed prominently at the top of the page                 |

White-label customization applies only to the invitation (and legacy magic link) pages. It does **not** affect the main Nectar dashboard, email notifications, exported files, or the Nectar login page.

## How to set it up

<Steps>
  <Step title="Go to White Label settings">
    Navigate to [**Settings > Organization > Developer**](https://dash.nectarclimate.com/settings/organization/developer) and scroll to the **White Label** section.
  </Step>

  <Step title="Enter your company name">
    This is the name your clients will see in the invitation header. Use your official company name or the brand name your clients recognize.
  </Step>

  <Step title="Choose your brand color">
    Enter a hex color code like `#FF5733` or `#2E86AB`. This color will be used for buttons, links, and accent elements on the invitation page.
  </Step>

  <Step title="Enter your logo URL">
    Provide a publicly accessible web address for your logo image. The URL must start with `https://` and point directly to the image file. Test by opening the URL in a private browser window — if you can see the image, Nectar can too.
  </Step>

  <Step title="Preview your changes">
    The settings page shows a **live preview** that updates as you type. Check that the logo renders clearly, the colors look right, and the company name displays correctly before saving.
  </Step>

  <Step title="Save">
    Click **Save** to apply your changes. They take effect immediately for all new and existing invitations.
  </Step>
</Steps>

## Logo guidelines

* **Format**: PNG with a transparent background or SVG work best. JPEGs work too but may show a white box on non-white backgrounds.
* **Size**: Aim for around **200 × 50 pixels**. Wide horizontal logos work better than tall square ones.
* **Contrast**: Make sure your logo is clearly visible on a white background. White or very light logos won't show up.
* **Hosting**: The URL must be publicly accessible. If you're unsure, open it in a private/incognito browser window to verify.

## Color guidelines

* Choose a color with **strong contrast** against white. Very light colors (pastel yellow, light gray) will make buttons hard to read.
* Test your color in the live preview before saving.
* Stick to your **primary brand color** for a clean, professional result.

## Real-world example

You're "Apex Energy Advisors" and your brand color is a deep teal (`#0D7377`). Your logo is hosted at `https://apexenergy.com/logo.png`.

After configuring white-label:

* Your client clicks an invitation link in their email
* Instead of seeing "Connect your utility account with Nectar," they see "Connect your utility account with Apex Energy Advisors"
* The page shows your Apex logo and teal buttons
* Your client has no idea Nectar exists — to them, this is your tool

## Availability

White-labeling is a premium feature. Contact [support@nectarclimate.com](mailto:support@nectarclimate.com) for access and pricing details.

<Tip>
  See [Invitations](/platform/data-input/invitations) to understand the full end-user experience
  that your branding is applied to.
</Tip>

## FAQ

<AccordionGroup>
  <Accordion title="What logo size works best?">
    Around **200 × 50 pixels** is ideal. The logo appears in a horizontal header area, so wider logos look better than tall ones. You can test different sizes using the live preview in the settings page.
  </Accordion>

  <Accordion title="Can I use a custom domain for invitations?">
    Custom domains for invitation pages are not currently available. Invitations are served from Nectar's domain, but with your branding applied visually. Contact [support@nectarclimate.com](mailto:support@nectarclimate.com) to discuss options.
  </Accordion>

  <Accordion title="Does white-label affect the Nectar dashboard?">
    No. White-label customization only applies to the invitation pages your clients see. The main Nectar dashboard remains unchanged.
  </Accordion>

  <Accordion title="How long do changes take to apply?">
    Changes take effect immediately after saving. Invitations that were already sent will also reflect the new branding when opened, since the branding is applied at page load time.
  </Accordion>

  <Accordion title="What image formats are supported?">
    **PNG**, **SVG**, **JPEG**, and **WebP** are all supported. PNG with a transparent background is recommended for the cleanest look. SVG scales perfectly at any size. Avoid GIF or animated images.
  </Accordion>

  <Accordion title="Can I preview changes before saving?">
    Yes. The white-label settings page includes a **live preview** that updates as you type. You can see exactly how the invitation page will look with your company name, color, and logo before committing the changes.
  </Accordion>
</AccordionGroup>