How to Access High-Resolution Gift Card Images in the Tillo Hub

While our standard Hub view provides web-optimized images for daily use, there are times you might need a high-resolution version of a gift card image. This article guides you through a quick, advanced workaround to access and download the highest-resolution gift card images (1320x856) directly from the Tillo Hub by making a simple tweak to the image URL.

This is a temporary workaround. Our roadmap includes a native API update that will surface these 1320 x 856 images automatically without requiring URL manipulation.

⚠️ Important Note: The final image clarity depends on the original file provided by the brand. Not all brands in the hub will be available in high-resolution.

🔍 Image Quality 

Because we are pulling larger assets, the final image clarity depends on the original file provided by the brand. The URL modification will always return a larger image size, but it will fall into one of two categories:

• True High-Res: The image remains crisp, sharp, and pixel-perfect.

• Upscaled: The image may look slightly soft or pixelated (meaning we are currently awaiting a native high-res source asset from that specific brand partner).

To download a high-res asset for a specific brand, follow these steps: 

Step 1: Navigate to brand details page

Log into your Partner Hub, navigate to the Brands tab, and select the brand you need. On the left side of the brand details page, you will see the Gift Card image.

Step 2: Open the Gift Card Image in a New Tab

Right-click on the Gift Card image and select Open image in new tab.

Step 3: Modify the URL Dimensions

In your browser’s address bar, look at the image URL. Find the text 330x214 and manually replace it with 1320x856.

• Standard URL: https://assets.tillo.io/v2/images/brands/vouchers/330x214/primark

• Modified URL: https://assets.tillo.io/v2/images/brands/vouchers/1320x856/primark

The file extension (usually .png or .jpg) should remain exactly as it is; only remove the sizing modifier.

True High-Res Example: Sharp Photo Returned 

Before: 

 After: 

Upscaled Example: Pixelated/enlarged image returned

Before:

After:

Step 4: Refresh and Save

Hit Enter on your keyboard to load the high-resolution image. Visually inspect the quality, then right-click the image and select Save image as to download your asset.

🛠️ How to automate it (For Developers)

If your team needs to pull high-resolution images programmatically across a wide range or all of your active brands, your developers can implement a simple string-replacement rule in your code.

The Workflow:

1. Call the Endpoint: Query the List Brands endpoint.

2. Locate the Field: Look for the gift_card_url field returned in the payload. By default, this URL string contains the 330x214 dimensions.

3. Apply the Code Fix: Have your technical team programmatically replace the string 330x214 with 1320x856 within the URL path before rendering the image in your application.

This is a temporary workaround. Our roadmap includes a native API update that will surface these 1320 x 856 images automatically without requiring URL manipulation.

Still have questions?  Reach out to the Client Services team at servicedesk@tillo.io.