> ## Documentation Index
> Fetch the complete documentation index at: https://docs.palazzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration

> Integrate Palazzo into your website with deep linking and URL parameters for seamless user experiences.

Integrate Palazzo directly into your website or application by passing parameters through URLs. This allows you to create seamless workflows where images are automatically loaded and products are pre-selected, eliminating manual steps for your users.

## Preloading Images with `image_url`

Automatically load an image into the Design Assistant by passing an `image_url` parameter in the URL. This allows users to skip the manual upload step and jump straight into the design process.

### How It Works

Append the `image_url` parameter to the Palazzo URL with a publicly accessible image URL:

```
https://app.palazzo.ai/?image_url=https://example.com/room-image.jpg
https://[your_instance].palazzo.ai/?image_url=https://example.com/room-image.jpg
```

<Note>Replace `[your_instance]` with the name of your instance.</Note>

### Requirements

* The image URL must be publicly accessible
* Max file size: 10MB
* Supported formats: JPG, PNG, or WEBP
* High-resolution images are recommended for best results

### Example

```
https://my_store.palazzo.ai/?image_url=https://your-site.com/images/living-room.jpg
```

When users visit this URL, the Design Assistant will automatically load the specified image and proceed to the design process.

## Preselecting Products with `sku`

Automatically pre-select a product in the Design Assistant by passing a SKU as a query parameter. This allows users to start with a specific product already selected.

### How It Works

Append the `sku` parameter to the Palazzo URL with a single product SKU:

```
https://app.palazzo.ai/?sku=PROD-12345
https://[your_instance].palazzo.ai/?sku=PROD-12345
```

### Requirements

* SKU must match a product available in your product catalog
* Invalid or non-existent SKUs will be ignored
* Product must be active and available for selection

### Example

```
https://my_store.palazzo.ai/?sku=BED-FRAME-001
```

## Combining Parameters

Create a fully automated workflow by combining both `image_url` and `sku` parameters:

```
https://app.palazzo.ai/?image_url=https://example.com/room.jpg&sku=PROD-12345
```

This will automatically load the image and pre-select the specified product, providing users with a complete starting point for their design.

### Complete Example

Direct users from a product page to the Design Assistant with the room image loaded and product pre-selected:

```
https://my_store.palazzo.ai/?image_url=https://your-site.com/rooms/bedroom.jpg&sku=BED-FRAME-001
```

When users visit this URL, they'll see the bedroom image loaded with the bed frame already selected, ready to visualize in the space.
