> ## Documentation Index
> Fetch the complete documentation index at: https://nectarclimate.com/docs/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](/docs/platform/premium/faq).
</Tip>

If you send [invitations](/docs/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 and magic-link experience with your own branding, so recipients 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 and magic-link experience** — the pages recipients see when they connect 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 to invitation and magic-link pages. It does **not** affect the main Nectar dashboard, exported files, or the Nectar login page. Branded **magic-link emails** may show your company name; other transactional product emails are unchanged.

## 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 recipients will see in the invitation header and on magic-link pages and emails. 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`, or use the color picker. This color will be used for buttons, links, and accent elements on the invitation page.
  </Step>

  <Step title="Add your logo">
    Upload a logo file with the dropzone (**Drop your logo here**). PNG, JPG, SVG, and WebP are supported (max 5 MB). Optionally paste a publicly accessible image URL as a fallback — the URL must start with `https://` and point directly to the image file.
  </Step>

  <Step title="Show MFA setup guidance (optional)">
    Turn on **Show MFA setup guidance** if you want public MFA setup forms (for magic links and invitations) to include a link to MFA documentation.
  </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 changes** to apply your settings. 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**: Uploaded logos do not need a public URL. If you use the optional URL field instead, the address must be publicly accessible — 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`). You upload your logo (or host it 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](/docs/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 and magic-link 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 via upload (max 5 MB). PNG with a transparent background is recommended for the cleanest look. SVG scales perfectly at any size. Avoid GIF or animated images. You can also supply a public HTTPS image URL instead of uploading.
  </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>