> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livearf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Settings

> Configure global behaviour for LIVEVUE across your Shopify store.

## Overview

Settings controls global behaviour across all your LIVEVUE components and products. Go to **LIVEARf → Settings** in your Shopify admin. You will see six tabs on the left — click any tab to configure that section. Changes reflect immediately in the **Preview Area** on the right.

***

## Settings Tabs

<Tabs>
  <Tab title="General">
    The General tab controls language, size display, artwork image selection, and custom size/mat limits.

    ***

    ### Language

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-general-language.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=96ba6076f1bb620d4c22df1a94c903b3" alt="General tab — Select Language dropdown showing English, French, Tamil, Turkish, Swedish, Português Brasil" width="1912" height="796" data-path="images/settings/settings-general-language.png" />

    | Setting             | What it does                                                 |
    | ------------------- | ------------------------------------------------------------ |
    | **Select Language** | Sets the display language for storefront labels and messages |

    Available languages: English, French, Tamil, Turkish, Swedish, Português (Brasil).

    ***

    ### Size Display

    Controls how product dimensions are shown to customers on the product page.

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-general-size.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=6649e88f20b5c0aa706e2c3fdc40b38f" alt="Size dropdown showing Print Image Size and Outer Framed / UnFramed - Finished Product Size options" width="1917" height="797" data-path="images/settings/settings-general-size.png" />

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-general-size-tooltip.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=428aab4eefc08551b6efb9647297f26b" alt="Size tooltip explaining the difference between Print Image Size and Finished Product Size" width="1907" height="802" data-path="images/settings/settings-general-size-tooltip.png" />

    | Option                                              | What it shows                             |
    | --------------------------------------------------- | ----------------------------------------- |
    | **Print Image Size**                                | Artwork dimensions only — e.g. 8×10 print |
    | **Outer Framed / UnFramed — Finished Product Size** | Full outer dimensions including the frame |

    ***

    ### Clean Artwork Image

    Defines which product image is used as the clean artwork for virtual framing and room previews.

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-general-clean-artwork.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=75c7a7a0a081f389ce398101b1e8c097" alt="Clean Artwork Image dropdown showing First Image, Second Image, Last Image options" width="1892" height="795" data-path="images/settings/settings-general-clean-artwork.png" />

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-general-clean-artwork-tooltip.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=6dbacd5ec8c258ab404e4afbf505d498" alt="Clean Artwork Image tooltip — clean artwork image needed for virtual framing, select which image to use as the clean version" width="1912" height="812" data-path="images/settings/settings-general-clean-artwork-tooltip.png" />

    | Option           | When to use                                                     |
    | ---------------- | --------------------------------------------------------------- |
    | **First Image**  | Your first product image is the clean artwork                   |
    | **Second Image** | Second image is a clean version without background distractions |
    | **Last Image**   | Last image in the product gallery is the clean artwork          |

    <Tip>
      Use a clean, high-resolution image with no background clutter as your designated artwork image. This is what customers see in the framing preview and room view.
    </Tip>

    ***

    ### Custom Size & Mat Selection

    Sets the allowed minimum and maximum values when customers enter custom sizes or mat dimensions.

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-general-custom-sizes.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=9d665251f9cb7b2f9cbba5c6e786aff7" alt="Custom Size Selection and Custom Mat Selection showing min/max fields and toggle options" width="1902" height="781" data-path="images/settings/settings-general-custom-sizes.png" />

    **Custom Size Selection:**

    | Field                        | Purpose                                   |
    | ---------------------------- | ----------------------------------------- |
    | **One Side Min (W/H/L)**     | Minimum value for the primary dimension   |
    | **One Side Max (W/H/L)**     | Maximum value for the primary dimension   |
    | **Another Side Min (W/H/L)** | Minimum value for the secondary dimension |
    | **Another Side Max (W/H/L)** | Maximum value for the secondary dimension |

    **Custom Mat Selection:**

    | Field                | Purpose                  |
    | -------------------- | ------------------------ |
    | **Min / Max Width**  | Allowed mat width range  |
    | **Min / Max Height** | Allowed mat height range |

    **Toggle options:**

    | Toggle                      | What it enables                                       |
    | --------------------------- | ----------------------------------------------------- |
    | **Printing Material Size**  | Includes material size in the custom size calculation |
    | **Mat (Single / Double)**   | Enables single or double mat configuration            |
    | **Frame**                   | Includes frame dimensions                             |
    | **Overall Outer Dimension** | Shows total outer dimension to customers              |
  </Tab>

  <Tab title="Preview Icons">
    Controls the position and alignment of the preview icons (Frame, Room, 3D, Gallery, AR) on your product page. Configure separately for Mobile and Desktop.

    ***

    ### Icons — Top Position

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-preview-icons-top.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=08cd414b3ad3ab6c9f1ac40092490612" alt="Preview Icons — Mobile selected, Vertical Position = Top, icons shown at top of the Preview Area" width="1907" height="795" data-path="images/settings/settings-preview-icons-top.png" />

    ### Icons — Bottom Position

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-preview-icons-bottom.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=cc976dec0ea139b30e4520765134cbdd" alt="Preview Icons — Vertical Position = Bottom, icons shown at the bottom of the Preview Area" width="1902" height="797" data-path="images/settings/settings-preview-icons-bottom.png" />

    ***

    ### Position Controls

    | Setting                 | Options               | What it does                                            |
    | ----------------------- | --------------------- | ------------------------------------------------------- |
    | **Device**              | Mobile / Desktop      | Configure each device independently                     |
    | **Vertical Position**   | Top / Bottom          | Places the icon bar at the top or bottom of the preview |
    | **Horizontal Position** | Left / Center / Right | Aligns the icon bar horizontally                        |
    | **Icon Alignment**      | Horizontal / Vertical | Arranges icons in a row or a column                     |

    **Available icons:** Frame, Room, 3D, Gallery, AR

    <Note>
      The Preview Area updates live as you change position settings. Verify on both Mobile and Desktop before saving.
    </Note>
  </Tab>

  <Tab title="Room View">
    Controls the room preview experience — feature toggles, room image categories, and per-room line size.

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-room-view.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=45746d616b4c8a464810e558d35d1a56" alt="Room View tab — feature toggles, size categories (Small/Medium/Large/Extra Large), and room images table with Line Size" width="1912" height="792" data-path="images/settings/settings-room-view.png" />

    ***

    ### Feature Toggles

    | Feature                     | What it does                                                |
    | --------------------------- | ----------------------------------------------------------- |
    | **Room Wall Colour Change** | Lets customers change the wall colour in the room preview   |
    | **Size Based Change**       | Automatically switches the room scene based on artwork size |
    | **Buyer Upload Own Room**   | Allows customers to upload their own room photo             |
    | **Enlarge View**            | Enables a full-screen expanded room preview                 |

    ***

    ### Room Categories

    Room images are organised by artwork size. Each category displays automatically when the artwork matches that size range.

    | Category        | Size Range     |
    | --------------- | -------------- |
    | **Small**       | 1 – 30 inch    |
    | **Medium**      | 31 – 70 inch   |
    | **Large**       | 71 – 120 inch  |
    | **Extra Large** | Above 120 inch |

    For each room image, set the **Label** (display name) and **Line Size** (visual line thickness used in that room scene).

    <Tip>
      Upload at least one room image per category so customers always see a relevant room regardless of the artwork size they select.
    </Tip>
  </Tab>

  <Tab title="Gallery View">
    Controls the gallery preview position and default image. Configure separately for Mobile and Desktop.

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-gallery-view.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=dde97a5294ecd98d07ab695bac50b0ab" alt="Gallery View — Vertical Position = Bottom, Horizontal Position = Center, Gallery Default Image Display = First Image, gallery thumbnails shown in Preview Area" width="1907" height="787" data-path="images/settings/settings-gallery-view.png" />

    ***

    | Setting                           | Options                                 | What it does                                           |
    | --------------------------------- | --------------------------------------- | ------------------------------------------------------ |
    | **Device**                        | Mobile / Desktop                        | Configure each device independently                    |
    | **Vertical Position**             | Top / Bottom                            | Places the gallery bar at the top or bottom            |
    | **Horizontal Position**           | Left / Center / Right                   | Aligns the gallery bar horizontally                    |
    | **Icon Alignment**                | Horizontal / Vertical                   | Arranges gallery thumbnails in a row or column         |
    | **Gallery Default Image Display** | First Image / Second Image / Last Image | Which product image is shown by default in the gallery |
  </Tab>

  <Tab title="Add to Cart">
    Controls the loading animation and messages shown to customers while their product is being added to the cart.

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-add-to-cart.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=fa020ef44dd977880f25b99e6f66c4b3" alt="Add to Cart — Loader toggle ON, Loader Message Interval = 2 sec, custom messages panel with Add button, loader preview on right" width="1901" height="797" data-path="images/settings/settings-add-to-cart.png" />

    ***

    | Setting                     | What it does                                                         |
    | --------------------------- | -------------------------------------------------------------------- |
    | **Loader**                  | Toggle ON to show an animated spinner during the add-to-cart process |
    | **Loader Message Interval** | How long (in seconds) each message is displayed before rotating      |
    | **Loader Messages**         | Custom text messages shown while the product is loading              |

    Click **Add** to create a new message. Each message can be up to 50 characters. Messages rotate at the interval you set.

    **Example messages:**

    * Adding to Cart!
    * Preparing Preview!
    * Uploading Artwork!
    * Generating Frame Preview!

    <Tip>
      Keep messages short and reassuring. Customers are more likely to wait through a loader when they can see something happening.
    </Tip>
  </Tab>

  <Tab title="Image Upload">
    Controls PPI (pixels per inch) quality validation when customers upload their own images. Prevents low-resolution uploads from being submitted for printing.

    <img src="https://mintcdn.com/acumentec/xDF0bxmy6aoULaqo/images/settings/settings-image-upload.png?fit=max&auto=format&n=xDF0bxmy6aoULaqo&q=85&s=8c90aa238ef583f12ec41e4ad9f62ae3" alt="Image Upload — PPI Calculation toggle ON, quality thresholds configured, customer-facing resolution warning shown in Preview Area" width="1912" height="797" data-path="images/settings/settings-image-upload.png" />

    ***

    Toggle **PPI Calculation ON** to enable automatic quality checking on every uploaded image.

    ### Quality Thresholds

    | Quality Level        | Default Max PPI | Result for customer                         |
    | -------------------- | --------------- | ------------------------------------------- |
    | **Can't be printed** | 50              | Blocked — image too low resolution to print |
    | **Poor Quality**     | 100             | Warning message shown                       |
    | **Average to Poor**  | 150             | Warning message shown                       |
    | **Average Quality**  | 225             | Advisory message shown                      |
    | **Good Quality**     | 300             | No warning — image accepted                 |

    **Example customer-facing message:**

    > *"Resolution: 63 PPI – Poor Quality, consider reducing the image size."*

    <Warning>
      If PPI Calculation is OFF, low-resolution images are accepted without any warning. Keep this toggle ON for all stores that accept customer image uploads to avoid poor-quality print orders.
    </Warning>
  </Tab>
</Tabs>

***

## What's Next?

<CardGroup cols={2}>
  <Card title="Pricing Plans" icon="credit-card" href="/livevue/pricing-plans">
    Understand how your monthly plan is calculated.
  </Card>

  <Card title="Artwork Component" icon="image" href="/livevue/artwork-component">
    Configure frame and mat options for your products.
  </Card>
</CardGroup>
