Skip to main content

Adding a Custom Image to a Referral Reward

Upload your own image for a Basic Referrals reward, and replace or remove it later.

Written by Kris James

The reward must be saved before you can add an image. If you have not set up your rewards yet, see: Configuring a Basic Referral Reward.

You can upload your own image for each Basic Referrals reward. It is a simple way to make a reward feel more on-brand.

The image is added from a card on the right of the reward page. The card is called Reward Icon for discount and free shipping rewards, and Reward Image for free product rewards.


How to Add a Custom Image

  1. Open Mage Loyalty > Referrals, then click Basic Referrals in the Referrals menu on the left.

  2. Click Edit next to the reward you want to update.

  3. In the Reward Icon (or Reward Image) card on the right, click the upload area under Custom icon (or Custom image), or drag your file onto it.

  4. Choose your image file. A preview appears once it has uploaded.

  5. Click Save in the bar at the top of the page.

The card only appears on a reward that has already been saved. If you have just created a reward, go back to Basic Referrals and click Edit on it.


Image Guidelines

Guideline

Recommendation

File types

JPEG, PNG, WEBP or SVG.

File size

Up to 5MB. Smaller files load faster for your customers, so aim for well under 1MB.

Shape

Square images work best. The image is shown in full inside a small box, so very tall or very wide images will look small.

Resolution

At least 600px wide, so the image stays sharp.

Use a branded graphic, product shot or lifestyle photo that makes the reward feel real and worth sharing.


Free Product Rewards

For a Free Product reward, the Reward Image card shows your product's own photo by default. Upload a custom image only if you want something other than the product photo. Your custom image then replaces the product photo in the customer's list of rewards in the Rewards Widget.


Replacing or Removing the Image

Once an image has been added, the card shows it with two buttons:

Button

What it does

Replace

Choose a new file to use instead.

Remove

Removes the custom image. Discount and free shipping rewards go back to the standard coupon icon, and free product rewards go back to the product photo.

Click Save in the bar at the top of the page after replacing or removing an image.


Changing the Look of All Your Reward Icons

If you would rather restyle the standard coupon icon than upload an image, click Edit design on the preview in the Reward Icon card. This opens the Icon Designer, where you can change the look of the coupon icon for all of your rewards at once.

Edit design needs the Starter plan or above. It is only shown for discount and free shipping rewards that do not have a custom image.


Common Mistakes to Avoid

Forgetting to click Save after uploading. The image is not kept on the reward until you click Save in the bar at the top of the page.

Uploading a very large image. Big files are slow to load for your customers. Compress images before uploading and aim for well under 1MB.

Using a very tall or very wide image. It will look small in the preview box. Crop it to a square first.


Troubleshooting

I cannot find the Reward Icon card

  • The card only shows on a saved reward. Go to Referrals > Basic Referrals and click Edit on the reward.

My image will not upload

  • Check the file is a JPEG, PNG, WEBP or SVG. Other file types show the message "That file type isn't supported".

  • Check the file is under 5MB.

The Edit design button is missing

  • The button is hidden while the reward has a custom image. Click Remove to see it again.

  • It is not shown for free product rewards.

  • It needs the Starter plan or above.

Did this answer your question?