Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 72 additions & 0 deletions content/collections/docs/white-labeling.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
---
title: 'White Labeling'
intro: 'White Labeling allows you to customize the logo, visible name, and basic theme of the CMS throughout the control panel.'
template: page
stage: 'Needs Polish & Humor'
updated_by: 3a60f79d-8381-4def-a970-5df62f0f5d56
updated_at: 1612297554
id: 5bd9426f-23cf-4196-9848-471dff67f5ea
---

## Configuration
Your White Label options are available in `config/statamic/cp.php` or through their corresponding .env variables.

> Keep in mind that according to the license terms you can only rebrand for personal, internal, or client usage. You cannot resell Statamic under another name.

### CP Theme

You can choose to switch the default "rad" login theme with a more vanilla (and boring) "business" theme.

``` php
'theme' => env('STATAMIC_THEME', 'rad'),
```

**Available options**:

- `rad`
- `business`

<div class="screenshot">
<img src="/img/white-label-login.png" alt="Statamic White Label Theme">
<div class="caption">Here's the "business" theme with a custom logo</div>
</div>

### Custom CMS Name

Set a custom name for the CMS.

``` php
'custom_cms_name' => env('STATAMIC_CUSTOM_CMS_NAME', 'Statamic'),
```

### Custom Logo

Swap out the logo with a URL to one of your own.

``` php
'custom_logo_url' => env('STATAMIC_CUSTOM_LOGO_URL', null),
```

You may set different logos for inside and outside Control Panel (nav bar and login screen, respectively) by passing an array.

``` php
'custom_logo_url' => [
'nav' => '/logo-white.png',
'outside' => '/logo-dark.png'
],
```

### Custom Favicon

Swap out the favicon with a URL to one of your own.

``` php
'custom_favicon_url' => env('STATAMIC_CUSTOM_FAVICON_URL', null),
```
### Custom CSS

Set the path to a CSS file and easily add your own styles to the control panel.

``` php
'custom_css_url' => env('STATAMIC_CUSTOM_CSS_URL', null),
```
2 changes: 2 additions & 0 deletions content/navigation/docs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -94,6 +94,8 @@ tree:
entry: cdffd2c9-cf42-495d-a8f1-f416ddfddc29
-
entry: 79129d32-3f7c-4215-b6b1-21a2fccafa8d
-
entry: 5bd9426f-23cf-4196-9848-471dff67f5ea
-
entry: 4b77c19b-129c-4271-a724-eea884eb3e2e
-
Expand Down
Binary file added public/img/white-label-login.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.