Images can be used across multiple features in Octane AI. Here's a quick reference for best practices when formatting images for use with Octane AI.

Table of contents

1. How to size images

1.1. Opt-in Tools

1.2. Shop Quiz

1.3. Main Menu

1.4. In-bot Products

2. Image formats

3. Best practices

3.1. Creating a pop-up for desktop and mobile

3.2. Content width

3.3. Loading states in your shop quiz

1. How to size images

The maximum file size for attachments in Facebook Messenger is 25MB while the maximum resolution is 85 Megapixels. To make sure your images and videos display correctly in your bot, you should make sure files don't exceed these requirements.

When cropping your image for a particular feature, there are various image ratios that work best depending on the feature you're looking to attach an image to.

All ratios displayed below are in terms of width : height.

1.1. Opt-in tools

Images can be added to the welcome, exit intent and add-to-cart pop-ups. Each pop-up lets you use a main image and a background image, but the ratios can change for different layouts and devices.

Left aligned pop-ups include both the main image and the background image, but centered pop-ups will only display the background image.


If you're using a left aligned pop-up, you'll want to use these image ratios:

  • Main image: 3:5

  • Background image: 5:3

If you're using a centered pop-up:

  • Background image: 9:10

The exact ratio for a left aligned background image is 100:65. However, a 5:3 image should fit the space almost perfectly.

If you don't have a perfectly sized image available, our pop-up tool offers alignment options that let you customize how the image is cropped inside of your pop-up.


Pop-ups on mobile have a different format from pop-ups on desktop, and will have different ideal ratios as a result. In order to preview the mobile version of your pop-up, you'll have to navigate to your dashboard on a mobile device.

If you're using a left aligned pop-up:

  • Main image: 5:3

  • Background image: 3:5

If you're using a centered aligned pop-up:

  • Background image: 7:10

The option to disable images for mobile is available. However, if you aren't happy with how your desktop pop-up looks on mobile devices, we recommend creating a separate pop-up for each device instead of disabling images.

Check out how to make a separate pop-up for different devices here.

1.2. Shop Quiz

Images can be used in the answers, product blocks and additional content of shop quiz.

Images in the quiz must:

  • be a maximum of 25 MB in size.

  • can be vector images (such as SVG files)

We recommend optimizing images for display on the web to avoid any impacts on your quiz's loading speed.

Background image

One background image is currently used for both desktop and mobile quizzes.

Background image sizes are recommended to be at least 2000px wide for image quality purposes.


Answer ratios are used for image choice sections, which allow you to display images in the answer to a multiple choice question.

  • Square/Circle: 1:1

  • Portrait: 2:3

  • Landscape: 3:2

Product blocks

Product blocks let you customize how product images are displayed on your results pages. Each product block has separate layout settings, so you can mix different types on the same results page by adding multiple product blocks.

  • Square: 1:1

  • Portrait: 2:3

  • Landscape: 3:2

Additional content

Additional content doesn't include pre-formatted layout options. Instead, you set the max width of the image you upload.

The max width of an image won't be able to exceed the max content width of your Shopify store. By default, this is set to 1084px in your quiz's global settings (under Layout), but you can set this to any custom amount.

For more information, jump ahead to the content width section in best practices!

1.3. Main Menu

Custom main menu items let you link the item to other bot features, or any external link. When creating one, you'll have to upload an image.

An image ratio of 2:1 will fit a main menu item perfectly.

1.4. In-bot Products

Your Octane AI bot can display products straight from your Shopify store in a Messenger chat.

Product images are cropped inside a 2:1 area.

The product images themselves are pulled straight from Shopify, so they aren't uploaded in Octane AI and can't be separately formatted.

2. Image formats

Various image formats can be ideal for different purposes. However, a good rule of thumb is the smaller the file size, the more efficiently the image will be able to upload and display.

Here are a few common image types and when you might want to use them. While there are many other image file formats, the following tend to be the best to use for displaying images on the web.


JPG images tend to be size-efficient and are great at compressing without a noticeable loss in color or quality.

If your concern is with file size and/or the image is a photo, JPG files can be the best choice.


The biggest advantage PNG files offer over JPG files is that they can have transparent backgrounds.

If you have a file with a transparent background, or for images types like logos, PNG can be the best choice.


Animated GIFs can be used in your shop quiz. You can use them to help your quiz's vibe or use an explainer page to display a loading state.

For details on how to do this, jump ahead here.

3. Best practices

Octane AI offers a lot of customization when designing the visual aspects of your tools. Here are some powerful tricks to keep in mind when choosing how to use images with your bot.

3.1. Creating a pop-up for desktop and mobile

You can create multiple pop-ups for each of your pop-up opt-in tools. By using different placement settings for each pop-up, you can display a different pop-up on different devices or even specific pages.

This will make sure your pop-up images and designs never conflict.

Creating a new pop-up is simple - just click on "New pop-up" on the page of the specific widget.

You'll be able to make up to 3 separate pop-ups, each with their own designs, messaging and placement settings.

When customizing a pop-up, you can specify where it will appear in its placement settings.

Creating a separate pop-up for separate devices lets you use the right image ratios for each type, and make sure your pop-ups look great on any screen.

3.2. Content width

In the shop quiz tool's global settings, you can change the max content width of your quiz under Layout.

By default, this is set at 1084px. If you use the body page embed setting for your shop quiz, you'll want to make the max content width match the content width of your Shopify store's theme to make sure layouts are consistent between the editor and your website.

For example, if your website's max content width is 800px, the setting here should also be 800px. Once that's set, the editor will do the rest of the heavy lifting.

3.3. Loading states in your shop quiz

Animated GIFs can be added to any quiz page as additional content. You can use additional content with questions, opt-ins, results or even in its own section using an explainer page.

By using this technique, you can create "loading states" in between your questions, or before your results - this adds a lot to your quiz's pace and vibe!

Here's a quick guide on how to turn an explainer page into a loading state.

1. Add an explainer page to your quiz.

2. On your new explainer page, set the page to advance after a set amount of time.

3. Under button settings, select the checkbox that will hide the "Continue" button.

4. Expand "Additional Content" and click "Add content". Choose the image option.

5. Upload the animated GIF you'd like to use. Wait until the file finishes uploading, then click "Add".

Max width can be used to make an image smaller. You can leave this blank if you'd like the image to be the maximum size possible.

Making content larger than the max content width isn't possible, so the image will automatically match the max content width in Layout settings if you enter a number too large.

6. Use text and any other additional content you'd like to add to customize the loading page.

Depending on how you'd like your quiz's vibe and pace to feel, you could add multiple loading states between questions, or you might only want a single one before your results.

If your quiz is on the longer side, you could have one introduce a particular set of questions in your quiz as well.

Want to learn more about how to use different sections in your shop quiz? Check out this article.

Did this answer your question?