White-label branding lets you customize the plugin’s appearance throughout the WordPress admin to match your organization’s brand. You can replace the PressPrimer name and logos with your own, adjust colors, and add custom CSS.

Accessing White-Label Settings

As an administrator, navigate to PressPrimer Quiz > Settings and select the White-Label tab. Toggle Enable White-Label to activate custom branding.

Branding Options

Plugin Name

Replace “PressPrimer Quiz” with your own name throughout the admin interface. This affects the admin menu, page titles, and welcome messages. Maximum 100 characters.

Dashboard Subtitle

Customize the welcome text displayed on the Dashboard (at PressPrimer Quiz > Dashboard). Use this to add a tagline or brief description. Maximum 200 characters.

Header Color

Change the background color of page headers on the Dashboard, Settings, and Reports pages. Enter a hex color code (e.g., #14B8A6) or use the color picker. The default is slate grey (#334155).

Custom Logos

You can upload custom images to replace the default PressPrimer branding in four locations:

• Menu Icon: The small icon shown in the WordPress admin sidebar menu. Recommended size: 20×20 pixels.
• Dashboard Logo: The logo displayed in the dashboard page header. Recommended size: 200×50 pixels or similar aspect ratio.
• Mascot Image: The decorative image shown in Settings and Reports page headers. If you prefer a cleaner look, you can hide this entirely using the “Hide Header Images” option.
• Quiz Logo: A logo that can be displayed on the front-end quiz interface.

Click the upload button next to each option to select an image from your Media Library or upload a new one.

Additional Options

Hide Header Images

Enable this option to remove decorative images from page headers entirely, giving the admin interface a more minimal appearance.

Custom CSS

Add custom CSS rules to further customize the admin interface appearance. This CSS is only loaded in the WordPress admin, not on the front-end of your site. Use this for fine-tuned adjustments beyond what the standard options provide.

Front End Branding

The Front End tab of the White-Label settings extends your branding to the student and instructor dashboard on the front end of your site. It requires PressPrimer Quiz 3.0.0 or higher; on older versions the tab shows a notice instead. See The Front-End Dashboard for the dashboard itself.

When white-label is enabled, your custom Plugin Name replaces the product name in the dashboard header and in the browser tab titles of dashboard pages, so students and instructors see your brand, not ours.

Shell Logo

The Shell Logo is shown in the front-end dashboard header. If you do not set one, the dashboard falls back to your Quiz Interface Logo, so a single logo upload can cover both surfaces.

Front-End Custom CSS

A separate Custom CSS field on the Front End tab applies only to the dashboard page. It is output after the dashboard’s own styles. Prefer the --ppq-* CSS custom properties for colors, spacing, and radius, and use this field only for what the design tokens do not cover. The admin Custom CSS field above is unaffected and continues to apply only in wp-admin.

Tips

• Use PNG images with transparent backgrounds for the best results with logos.
• Test your branding across different admin pages to ensure it looks consistent.
• If your header color is dark, the default white text should remain readable. For very light header colors, you may need custom CSS to adjust text colors.