---
title: Tùy biến thương hiệu
description: Gắn tên, logo, màu sắc và tiền tệ riêng lên portal khách hàng, admin console và email — quy chuẩn upload cùng vị trí hiển thị của từng cài đặt.
url: https://nexcmp.com/vi/docs/customers/branding/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Tùy biến thương hiệu {#branding}

> **Vị trí trong admin:** System › Settings › Brand (`/settings/branding`). Liên quan: System › Settings › General (`/settings`) cho URL và thông tin bên bán in trên hóa đơn.

## Chức năng {#what-it-does}

NexCMP hỗ trợ white-label: sản phẩm không mang tên nhà cung cấp, mọi thứ khách hàng nhìn thấy đều là thương hiệu của **bạn**. Cài đặt thương hiệu áp dụng cho các trang đăng nhập và đăng ký, portal, admin console cùng email.

## Yêu cầu {#requirements}

| Hạng mục | Yêu cầu |
|---|---|
| Role | Quản trị viên. |
| Tệp tin | Logo: SVG, PNG, JPEG, WEBP hoặc ICO, **dung lượng tối đa 512 KB mỗi tệp**. |
| Thành phần phụ thuộc | Không có. |

## Các bước thực hiện {#steps}

1. Mở **System › Settings › Brand**.
2. Tại thẻ **Identity**, điền các thông tin:

   | Trường | Ghi chú |
   |---|---|
   | **Brand name** (bắt buộc) | Tối đa 60 ký tự. Hiển thị trong portal, email, hóa đơn và các trang pháp lý. |
   | **Tên người bán trên hóa đơn** | Tối đa 120 ký tự. Để trống nghĩa là sử dụng tên thương hiệu. |
   | **Brand color** | Màu `#rrggbb`; nút nhỏ bên cạnh trường này sẽ đặt lại về màu mặc định. |
   | **Site currency** | **USD**: giá và số dư chỉ hiển thị bằng USD, không có nút chuyển đổi tiền tệ. **VND**: hiển thị thêm số tiền quy đổi theo tỷ giá được lưu trữ (xem [Tiền tệ và tỷ giá](https://nexcmp.com/vi/docs/catalog/currency-and-exchange-rates/)). |

3. Nhấp **Save**.
4. Trong thẻ **Logo & favicon**, tải lên ba hình ảnh — **Logo (light background)**, **Logo (dark background)** và **Favicon** — bằng **Upload** (hoặc **Replace**); **Remove** sẽ xóa ảnh.

![Trang Brand với các trường nhận diện và ba hình ảnh đã tải lên](https://nexcmp.com/vi/docs/images/customers/branding-01-brand.webp)

### Các cài đặt liên quan trong General {#related-settings-in-general}

**System › Settings › General** có hai tab để hoàn thiện cấu hình:

| Tab | Trường dữ liệu |
|---|---|
| **Branding & URLs** | Brand name (email, hóa đơn), ngôn ngữ mặc định (tiếng Anh hoặc tiếng Việt), **Customer app URL**, **Console URL**, **Admin URL** (liên kết mạo danh reseller) và **Partner console URL** (liên kết mời, email reseller). Trình hướng dẫn thiết lập sẽ điền sẵn các mục này bằng `https://<domain>`, `https://<domain>/admin` và `https://<domain>/console`. |
| **Seller & invoicing** | Tên pháp nhân, mã số thuế, địa chỉ, email liên hệ và tiền tố số hóa đơn. Xem [Hóa đơn và sổ cái](https://nexcmp.com/vi/docs/billing/invoices-and-ledger/). |

**From name** của email được thiết lập tại **System › Settings › Email** ([SMTP và email](https://nexcmp.com/vi/docs/administration/smtp-and-emails/)).

## Các tệp tải lên đều được kiểm tra {#uploaded-files-are-checked}

- Ảnh raster được nhận diện từ nội dung tệp (không phải từ tên tệp) và được đo kích thước.
- **Tệp SVG được dựng lại** từ danh sách các hình khối an toàn. Tệp chứa script, `foreignObject`, thuộc tính sự kiện, liên kết ngoài, `url(...)` trỏ ra ngoài, DOCTYPE hoặc entity sẽ **bị từ chối** (`svg_unsafe`).
- Tệp quá lớn sẽ bị từ chối với `asset_too_large`, sai định dạng với `asset_type`, kích thước không hợp lệ với `asset_dimensions`.
- Các tệp được phân phát từ chính domain của bạn với các security header nghiêm ngặt.

## Kiểm tra {#verify}

1. Mở trang đăng nhập portal trong cửa sổ ẩn danh: logo, tên và màu sắc sẽ xuất hiện.
2. Kiểm tra tab trình duyệt để xem favicon (trình duyệt lưu cache favicon; hãy tải lại sau khi xóa cache nếu bạn vẫn thấy favicon cũ).
3. Kích hoạt gửi thử một email (ví dụ **Send reset link** cho một khách hàng thử nghiệm) và kiểm tra tên thương hiệu trong tiêu đề cùng chân trang.

## Hạn mức & lưu ý {#limits-notes}

- Logo cho nền tối được sử dụng khi khách hàng hoặc admin chuyển sang dark theme.
- Reseller có thương hiệu riêng; họ tải lên tệp PNG, JPEG, WEBP hoặc ICO dung lượng tối đa 256 KB (không hỗ trợ SVG). Xem [Resellers](https://nexcmp.com/vi/docs/customers/resellers/).
- Thay đổi về màu thương hiệu hoặc logo sẽ hiển thị ở lần tải trang tiếp theo; các email đã gửi sẽ không bị thay đổi.

## Xử lý sự cố {#troubleshooting}

| Hiện tượng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| Tải lên bị từ chối: `svg_unsafe` | SVG chứa script, liên kết hoặc tham chiếu bên ngoài | Xuất tệp SVG thuần (không có script, không có ảnh bên ngoài) hoặc dùng PNG. |
| `asset_too_large` | Tệp vượt quá 512 KB | Nén hoặc thay đổi kích thước ảnh. |
| `asset_type` | Không phải SVG, PNG, JPEG, WEBP hoặc ICO | Chuyển đổi định dạng tệp. |
| `invalid_argument: primary` | Màu sắc không phải là `#rrggbb` | Sử dụng giá trị hex gồm 6 chữ số. |
| Vẫn hiển thị logo cũ | Bộ nhớ cache trình duyệt | Tải lại cứng (hard-reload); favicon có thể mất nhiều thời gian hơn để cập nhật. |
| Giá chỉ hiển thị bằng USD | Tiền tệ của trang là USD | Chuyển sang VND và đảm bảo tỷ giá đã được lưu. |