User Interfaces

Learn how to create beautiful and functional user interfaces for your UXP plugins

Overview

Every UXP plugin with a visual component needs a user interface. Whether you're building a simple dialog or a complex panel, UXP gives you multiple ways to create UI that looks and feels like a native part of Premiere.

UXP provides three approaches for building user interfaces:

1. Standard HTML Elements: familiar web technologies with custom styling.
2. Spectrum UXP Widgets: built-in, Adobe-styled components that work out of the box.
3. Spectrum Web Components (SWC): modern Web Component library with Adobe's design system.

Understand the Options

Before diving into the technical details, it's helpful to understand some key terminology:

• Spectrum: Adobe's open-source design language¹ and guidelines that ensure consistency across applications.
• Web Components: A set of HTML5 technologies that let you create custom, reusable HTML elements.
• Adobe Spectrum Web Components (SWC): An open-source library of pre-built Web Components styled according to Spectrum design guidelines.

Standard HTML Elements

These are the familiar HTML elements you've likely used before: <div>, <button>, <input>, <img>, <dialog>, and more. They follow web standards and give you complete control over styling through CSS.

Copy
<div class="container">
  <button class="primary-button">Click me</button>
  <input type="text" placeholder="Enter text" />
</div>
Copied to your clipboard
<div class="container">
  <button class="primary-button">Click me</button>
  <input type="text" placeholder="Enter text" />
</div>

Spectrum UXP Widgets

Spectrum UXP Widgets are built directly into the UXP platform. They provide ready-to-use, Adobe-styled components that automatically match Premiere's look and feel, including dark and light theme support.

Copy
<sp-button variant="primary">I'm a Spectrum button</sp-button>
<sp-textfield placeholder="Enter your name"></sp-textfield>
<sp-checkbox>Enable feature</sp-checkbox>
Copied to your clipboard
<sp-button variant="primary">I'm a Spectrum button</sp-button>
<sp-textfield placeholder="Enter your name"></sp-textfield>
<sp-checkbox>Enable feature</sp-checkbox>

These widgets are immediately available—no installation or imports required. Just use them like any other HTML tag.

Spectrum Web Components (SWC)

Spectrum Web Components are Adobe's official implementation of the Spectrum Design System using modern Web Component standards. They offer the most complete feature set and the closest adherence to Spectrum guidelines.

To use SWCs, you need to install each component individually via npm or yarn and import it in your code:

Copy
npm install @spectrum-web-components/button@0.37.0
npm install @spectrum-web-components/textfield@0.37.0
Copied to your clipboard
npm install @spectrum-web-components/button@0.37.0
npm install @spectrum-web-components/textfield@0.37.0

Then import and use them in your JavaScript:

Copy
import '@spectrum-web-components/button/sp-button.js';
import '@spectrum-web-components/textfield/sp-textfield.js';
Copied to your clipboard
import '@spectrum-web-components/button/sp-button.js';
import '@spectrum-web-components/textfield/sp-textfield.js';

Copy
<sp-button variant="primary">I'm a SWC button</sp-button>
<sp-textfield placeholder="Enter your name"></sp-textfield>
Copied to your clipboard
<sp-button variant="primary">I'm a SWC button</sp-button>
<sp-textfield placeholder="Enter your name"></sp-textfield>

You'll also need to enable SWC in your manifest.json:

Copy
{
  "featureFlags": {
    "enableSWCSupport": true
  }
}
Copied to your clipboard
{
  "featureFlags": {
    "enableSWCSupport": true
  }
}

Mix and Match

The best part? You can combine all three approaches in a single plugin. UXP seamlessly supports mixing HTML elements, Spectrum UXP Widgets, and Spectrum Web Components:

Copy
<form>
  <!-- Standard HTML element -->
  <div class="section">
    <!-- Spectrum Web Component -->
    <sp-banner>
      <div slot="header">Welcome</div>
      <div slot="content">This is a mixed UI example</div>
    </sp-banner>

    <!-- Spectrum UXP Widget -->
    <sp-button variant="primary">Submit</sp-button>
  </div>
</form>
Copied to your clipboard
<form>
  <!-- Standard HTML element -->
  <div class="section">
    <!-- Spectrum Web Component -->
    <sp-banner>
      <div slot="header">Welcome</div>
      <div slot="content">This is a mixed UI example</div>
    </sp-banner>

    <!-- Spectrum UXP Widget -->
    <sp-button variant="primary">Submit</sp-button>
  </div>
</form>

This flexibility lets you use the right tool for each part of your interface.

Which Approach Should You Choose?

Your choice depends on your project requirements, timeline, and experience level.

Start with Spectrum UXP Widgets if you:

• Are new to UXP development
• Want to quickly prototype an idea
• Need a simple UI with standard components
• Prefer zero configuration

Use Spectrum Web Components if you:

• Are building a production plugin
• Need access to the full Spectrum component library
• Want to inspect and debug component internals
• Are comfortable with npm and build tools

Use Standard HTML Elements if you:

• Need highly custom UI components
• Have specific design requirements beyond Spectrum
• Are comfortable writing custom CSS
• Want maximum control over styling and behavior

For most projects, we recommend starting with Spectrum Web Components, and using standard HTML elements for very specific custom needs. UXP Widgets are still supported but may be deprecated in the future.

Working with JavaScript Frameworks

While vanilla JavaScript, HTML, and CSS are sufficient for many plugins, complex applications can benefit from modern JavaScript frameworks. UXP plugins work well with popular frameworks like React, Vue, and Svelte.

These frameworks help you manage complex state, create reusable components, and build more maintainable code. However, they require additional setup including Node.js, package managers, and build tools.

If you're already familiar with React or plan to build a complex plugin, check out the Using Spectrum with React guide for tips on integrating Spectrum components with React. The most popular approach is to use React Wrappers for Spectrum Web Components.

Reference Documentation

Ready to start building? Explore the complete documentation for each UI approach.

• Spectrum Web Components: full SWC component library and usage examples.
• Spectrum UXP Widgets: built-in widget reference and API documentation.
• HTML Elements: supported HTML elements in UXP.
• HTML Tags Reference: complete HTML tag documentation.
• Using Spectrum with React: integration guide for React developers (see also the Working with Bundlers section of the UXP Developer Tool documentation).

For practical examples and working code, explore the CSS Styling recipe to learn how to customize your plugin's appearance.

Last updated 11/10/2025

Was this helpful?

Yes

No