Skip to main content
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
Replace [your_instance] with the name of your instance.

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.