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.