---
title: Branding
description: Pasang nama, logo, warna, dan mata uang Anda sendiri pada portal pelanggan, konsol admin, dan email — aturan unggah dan letak setiap pengaturan.
url: https://nexcmp.com/id/docs/customers/branding/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Branding {#branding}

> **Di mana letaknya di admin:** System › Settings › Brand (`/settings/branding`). Terkait: System › Settings › General (`/settings`) untuk URL dan detail penjual yang dicetak pada faktur.

## Fungsi {#what-it-does}

NexCMP bersifat white-label: produk tidak membawa nama vendor, dan semua yang dilihat pelanggan Anda adalah brand **Anda**. Pengaturan brand berlaku untuk halaman login dan pendaftaran, portal, konsol admin, dan email.

## Persyaratan {#requirements}

| Item | Persyaratan |
|---|---|
| Role | Seorang administrator. |
| File | Logo: SVG, PNG, JPEG, WEBP, atau ICO, **masing-masing hingga 512 KB**. |
| Dependensi | Tidak ada. |

## Langkah-langkah {#steps}

1. Buka **System › Settings › Brand**.
2. Di kartu **Identity**, isi:

   | Kolom | Catatan |
   |---|---|
   | **Brand name** (wajib) | Hingga 60 karakter. Ditampilkan di portal, email, faktur, dan halaman legal. |
   | **Nama penjual pada faktur** | Hingga 120 characters. Kosong berarti menggunakan nama brand. |
   | **Brand color** | Warna `#rrggbb`; tombol kecil di sebelah field akan meresetnya ke warna bawaan. |
   | **Site currency** | **USD**: harga dan saldo hanya ditampilkan dalam USD, tanpa tombol pengalih mata uang. **VND**: juga menampilkan jumlah yang dikonversi pada nilai tukar yang tersimpan (lihat [Currency and exchange rates](https://nexcmp.com/id/docs/catalog/currency-and-exchange-rates/)). |

3. Klik **Save**.
4. Di kartu **Logo & favicon**, unggah ketiga gambar — **Logo (latar belakang terang)**, **Logo (latar belakang gelap)**, dan **Favicon** — dengan tombol **Upload** (atau **Replace**); **Remove** menghapus salah satunya.

![Halaman merek dengan bidang identitas dan ketiga gambar yang diunggah](https://nexcmp.com/id/docs/images/customers/branding-01-brand.webp)

### Pengaturan terkait di General {#related-settings-in-general}

**System › Settings › General** memiliki dua tab yang melengkapi keseluruhan:

| Tab | Bidang |
|---|---|
| **Branding & URLs** | Nama merek (email, faktur), bahasa default (Bahasa Inggris atau Vietnam), **Customer app URL**, **Console URL**, **Admin URL** (tautan peniruan identitas reseller), dan **Partner console URL** (tautan undangan, email reseller). Wizard penyiapan mengisi ini dengan `https://<domain>`, `https://<domain>/admin`, dan `https://<domain>/console`. |
| **Seller & invoicing** | Nama badan hukum, NPWP/ID pajak, alamat, email kontak, dan awalan nomor faktur. Lihat [Invoices and ledger](https://nexcmp.com/id/docs/billing/invoices-and-ledger/). |

**Nama Pengirim (From name)** untuk email diatur di **System › Settings › Email** ([SMTP and e-mails](https://nexcmp.com/id/docs/administration/smtp-and-emails/)).

## File yang diunggah akan diperiksa {#uploaded-files-are-checked}

- Gambar raster dikenali dari kontennya (bukan dari nama file) dan diukur ukurannya.
- **File SVG disusun ulang** dari daftar bentuk yang aman. File yang berisi skrip, `foreignObject`, atribut kejadian, tautan eksternal, `url(...)` yang mengarah ke luar, DOCTYPE, atau entitas akan **ditolak** (`svg_unsafe`).
- File yang terlalu besar akan ditolak dengan `asset_too_large`, tipe yang salah dengan `asset_type`, dan dimensi yang buruk dengan `asset_dimensions`.
- File disajikan dari domain Anda sendiri dengan header keamanan yang ketat.

## Verifikasi {#verify}

1. Buka halaman login portal di jendela inkognito: logo, nama, dan warna akan muncul.
2. Periksa tab browser untuk favicon (browser menyimpan cache favicon; muat ulang dengan membersihkan cache jika Anda masih melihat yang lama).
3. Memicu email uji (misalnya **Send reset link** untuk pelanggan uji) dan periksa nama merek di subjek serta footer.

## Batas & catatan {#limits-notes}

- Logo untuk latar belakang gelap digunakan ketika pelanggan atau admin beralih ke tema gelap.
- Reseller memiliki merek mereka sendiri; mereka mengunggah PNG, JPEG, WEBP, atau ICO hingga 256 KB (tanpa SVG). Lihat [Resellers](https://nexcmp.com/id/docs/customers/resellers/).
- Perubahan warna atau logo merek akan langsung terlihat pada pemuatan halaman berikutnya; email yang sudah dikirim tidak akan berubah.

## Pemecahan Masalah {#troubleshooting}

| Gejala | Penyebab | Solusi |
|---|---|---|
| Pengunggahan ditolak: `svg_unsafe` | SVG memiliki skrip, tautan, atau referensi eksternal | Ekspor SVG biasa (tanpa skrip, tanpa gambar eksternal) atau gunakan PNG. |
| `asset_too_large` | File lebih dari 512 KB | Kompres atau ubah ukuran gambar. |
| `asset_type` | Bukan SVG, PNG, JPEG, WEBP, atau ICO | Konversi file tersebut. |
| `invalid_argument: primary` | Warna bukan `#rrggbb` | Gunakan nilai heksadesimal enam digit. |
| Logo lama masih terlihat | Cache browser | Muat ulang secara paksa (hard-reload); favicon mungkin membutuhkan waktu lebih lama. |
| Harga hanya ditampilkan dalam USD | Mata uang situs adalah USD | Beralih ke VND dan pastikan nilai tukar telah disimpan. |