> 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/bannersui/guides/import-psds-and-create-packages.md).

# Import a PSD

Upload PSD files, review layers and warnings, then create editable BannersUI packages.

Import turns uploaded PSD files into editable BannersUI package artboards.

***

## Import checklist

| Check                    | Why it matters                                              |
| ------------------------ | ----------------------------------------------------------- |
| Package name is valid    | The package can be saved and found later.                   |
| Layers are clearly named | Shared layers and locks are easier to manage.               |
| Background is identified | The template has one controlled background layer.           |
| Warnings are resolved    | Output, scaling, and assisted layouts are more predictable. |

## Start import

1. Upload the PSD file or files in the host platform.
2. Open the generated import in BannersUI.
3. Confirm or enter the package name.
4. Review the preview image and layer list.

## Review imported layers

For each layer, check that BannersUI recognized the intended content type. Rename unclear layers before continuing. If a layer name warning appears, resolve it during import when possible.

Designers can use import controls to:

* Rename layers.
* Change layer type.
* Merge layers.
* Assign a background layer.
* Choose whether missing layers should be hidden or all layers should be used when importing against a design set.

## Resolve warnings

The import dialog may warn about invalid package names, duplicate layer names, unrecognized layer names, missing required background intent, unsupported layer features, failed layer validation, or layer structure mismatches.

It is recommended to resolve warnings before continuing. A clean import produces more predictable scaling, shared layers, and assisted layout results.

## Continue to package creation

After warnings are clear:

1. Choose the package or preset setup requested by the workflow.
2. Continue from the import dialog.
3. Wait while BannersUI creates package data, artboards, media, previews, and manifest information.
4. Review the new package in the BannersUI editor.

If import fails, check whether unsupported PSD features need to be merged in Photoshop, whether each file uploaded successfully, and whether the package name is valid.


---

# 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/bannersui/guides/import-psds-and-create-packages.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.