> For the complete documentation index, see [llms.txt](https://docs.santacruzsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.santacruzsoftware.com/gemini-home/guides/editor-customization.md).

# Editor & Gallery Customization

Configure the web-based editors and media galleries to enforce branding guidelines and connect external assets.

BrandingUI utilizes interactive web-based design editors that can be custom-tailored to provide either creative freedom or strict, locked-down branding parameters for your users.

***

## The Three Editors

BrandingUI dynamically selects from three built-in editors based on the active asset type and screen size:

1. **Full-Featured HTML5 Web Editor**: Recommended for general use. Built fully on modern HTML5 web standards, it supports complex typography, layered editing, table management, and InDesign layout capabilities.
2. **Simple HTML Web Editor**: Forms-based and highly responsive, optimized for simple customization tasks or smaller displays (e.g., smartphones and tablets).
3. **Digital Package Editor**: Specifically engineered for customizing packages containing multiple different sizes (social ads, standard banner sets) simultaneously.

## Branding Restrictions (Locking down the HTML5 Editor)

To ensure brand consistency, administrators can restrict editor controls under **Global Settings -> Editors -> HTML5 Settings**:

* **Branding Controls**: Toggle the visibility of "Add Image", "Add Rectangle", and "Add Text" buttons to prevent users from introducing unauthorized design elements.
* **Text Restrictions**: Show Document Styles instead of fonts in the text palette. This forces users to choose from pre-approved brand styles defined in InDesign, disabling custom font selections.
* **Color Palettes**: Restrict the color picker to show *only* Document Colors or specific custom color families. You can also disable the option to input hex color codes manually.
* **Page Management**: Prevent users from adding, deleting, or reordering document pages.
* **Layout Safeguards**: Enable "Warn when finished if any text will not fit" to scan the entire job for overset/overflow text before allowing submission.
* **Layer Opacities**: Adjust background and foreground layers visibility and opacities (e.g., keeping foreground grids visible but locked during editing).

### Additional HTML5 Controls

Administrators can also configure:

* Image sizing limits, minimum image resolution, automatic gallery opening, and whether galleries receive a user ID.
* Default size, font, and style for new text frames; expandable-frame handles; temporary table borders; and Glyph previews.
* The initial page, page selector, opening zoom, editable-object highlighting, locked-frame access for approvers, off-page opacity, and custom guides.
* Auto-save interval, **Start Over**, browser font storage, and labels or confirmation messages for Finished and Cancel actions.

The **Simple HTML Web Editor** has a smaller settings surface, including its Finished label and preview resolution. BrandingUI can select it automatically when a browser or device is not compatible with the full editor, even if it is not the administrator's preferred default.

The **Digital Package Editor** provides corresponding image, text, label, auto-save, font-storage, overset, and interface-color controls for Package artboards.

## Media Galleries & Connections

BrandingUI connects with external servers and image galleries to provide users with approved image and background replacement options during editing.

### Gallery Connector URL

Under **Image Galleries Settings**, configure the **Gallery Connector URL** to point to a PrintUI gallery connector. This exposes approved collections of images (or page backgrounds) to end-users as they edit frames.

### Gallery Qualifiers XML (Dynamic Tokenization)

To pass custom criteria to your connector, you can input a Gallery Qualifiers XML block. BrandingUI supports several dynamic run-time tokens:

* `$T`: Substituted with the active Template name.
* `$U`: Substituted with the user's email address.
* `$UD`: Substituted with the domain portion of the user's email address (e.g. `yourcompany.com`).
* `$ID`: Substituted with the user's unique numeric ID.

*Example*: `<qualifier><key>template</key><value>$T</value></qualifier>` passes the template name dynamically so the connector returns only relevant matching assets.

### User Uploads & Connected Cloud Accounts

* **Local Uploads**: Toggle "Allow user to upload images" to permit end-users to upload custom images from their local disks.
* **Social Galleries**: Enable "Social galleries" and select connected cloud storage endpoints (including **Box**, **Dropbox**, or **Google Drive**) so users can safely import assets from their corporate folders.
* **Image Filtering**: If the connector supports it, allow gallery results to be filtered by frame names or keywords defined in the asset.
* **Background Galleries**: Configure a separate connector and qualifiers for replaceable full-page backgrounds.

## Modifying Assets & Warnings

When modifying digital packages or templates on the server, accidental modifications can affect active user jobs.

* By default, a prompt warning of these potential impacts appears whenever an administrator or designer goes to modify an asset.
* **Toggle Warning**: To streamline edits, users can enable or disable this confirmation notice via the **Show Modify Warning** toggle option found inside their user avatar dropdown menu.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.santacruzsoftware.com/gemini-home/guides/editor-customization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.