# Size Metafield
Source: https://docs.frameup.app/advanced/size-metafield

Set artwork size without variants

## Introduction

If you offer different size options for each artwork product we recommend using <a href="/customisation/variants#automatically-create-a-size-rule">size variants</a>.

If you only offer one size for each product you may prefer to use a metafield to set the artwork size.

Follow the steps below to create the "artwork.size" metafield for your store and set it for a product.

### 1. Create the metafield definition

On a product page in the Shopify admin, scroll down to the "Metafields" section and click "View all".

<img alt="Empty metafields section on product page" />

You should now see the product metafields for your store. You may already have some. Click "Add definition":

<img alt="Add a custom field to your products" />

You should see the "Add product metafield definition" screen. Type in the name of the metafield, e.g. "Artwork Size", then click where it says "custom.artwork\_size".

<img alt="Add product metafield definition" />

Delete the "custom.artwork\_size" and type in "artwork.size". <b>This must match exactly</b>:

<img alt="Set namespace and key to 'artwork.size' exactly" />

Set the type to "Single line text":

<img alt="Set type to single-line text" />

Now click "Save" at the top of the page to save this metafield definition.

### 2. Set artwork size for each product

Return to a product page in Shopify admin, scroll down to the Metafields section and you should be able to type in your artwork size like below:

<img alt="Set artwork size for a product" />

Click 'Save' and Frame Up will now automatically detect this as the artwork size.

<Card title="Frame Up Support" icon="message-circle-question" href="mailto:support@frameup.app">
  Our support team is ready to help! Click here to e-mail us with any questions
  you have about Frame Up.
</Card>


# Framing
Source: https://docs.frameup.app/customisation/frames

Manage how your artwork is presented

## Artwork presentation

In this section you can choose from a range of frame styles and control how artwork images are rendered.

<img alt="Artwork presentation" />

### Style

You can choose from a range of framing options. The preview on the left side of the page will update in realtime as you select different options. You'll see different framing options have different secondary options, e.g. when 'Frame' is selected you'll see a 'Frame Material' option below.

It's also possible to add a border and, for Frame type only, a raised mountboard.

If you offer more than one framing style you can also apply styles based on your variants, we'll cover this in a later section.

<Info>
  More framing options are available on the Advanced and Plus tiers with custom
  frame mouldings and materials possible with the Plus tier
</Info>

### Artwork Image

If you offer different artwork sizes (see <a href="/customisation/variants#automatically-create-a-size-rule">size variants</a>), Frame Up gives you options on how to render the artwork image within the frame.

Review the fit modes below to find the right fit for your store:

| Fit mode                        | Description                                                                                                                                                 |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Crop image to fit frame size    | The top & bottom or left & right sides of the artwork image are cropped so the artwork fits inside the frame. This fit mode is recommended for most stores. |
| Stretch image to fit frame size | The artwork image is stretched to fill the frame. This may distort the image.                                                                               |
| Adjust frame size to fit image  | The artwork image is not cropped or distorted. Instead the frame size is adjusted so it matches the aspect ratio of the artwork image.                      |

#### Size metafield

For artworks that are only sold at one size, it is also possible to use metafields to set the artwork size instead of using variants.

## Next step

Next we'll look at how to choose the room displayed in "View in a room" mode.

<Card title="Customisation: Rooms" icon="circle-arrow-right" href="/customisation/rooms">
  Learn how to customise "View in a room" mode
</Card>


# Product Type
Source: https://docs.frameup.app/customisation/product-type-filter

Enable the plugin only for some products

## Filtering by product type

If you sell a variety of product types, not just wall art, you can tell Frame Up which product types to associate with your wall art products. The plugin will then only be enabled for products that match the product types you choose.

<Card
  title="Shopify Help Center: Product types"
  icon={
<svg
  width="21"
  height="24"
  viewBox="0 0 21 24"
  fill="none"
  xmlns="http://www.w3.org/2000/svg"
>
  <path
    d="M17.858 4.66109C17.7732 4.65442 15.9703 4.52005 15.9703 4.52005C15.9703 4.52005 14.7181 3.27742 14.5809 3.13924C14.5475 3.10589 14.5065 3.08302 14.4618 3.06873L13.5688 23.7018L20.6235 22.1695C20.6235 22.1695 18.0791 4.96889 18.0629 4.85168C18.0467 4.73351 17.9428 4.66871 17.858 4.66109Z"
    fill="black"
  />
  <path
    d="M14.0702 3.07527C14.0549 3.08003 13.7967 3.15913 13.3698 3.29159C12.9514 2.08802 12.2138 0.982611 10.915 0.982611C10.8788 0.982611 10.8426 0.984517 10.8054 0.986423C10.4357 0.498517 9.9792 0.286011 9.58373 0.286011C6.5591 0.286011 5.11444 4.06728 4.66084 5.98841C3.48586 6.35243 2.65108 6.61163 2.54435 6.64499C1.88873 6.85082 1.86776 6.87179 1.782 7.48929C1.7172 7.95719 0 21.2317 0 21.2317L13.2468 23.7141L14.1407 3.05907C14.114 3.06383 14.0892 3.06955 14.0702 3.07527ZM10.7063 3.98438C10.7063 4.03012 10.7063 4.073 10.7053 4.11588C9.96872 4.34363 9.1692 4.5914 8.36778 4.83916C8.81757 3.10195 9.66187 2.26336 10.3994 1.94699C10.5853 2.41298 10.7063 3.08194 10.7063 3.98438ZM9.50083 1.09696C9.63138 1.09696 9.76288 1.1408 9.88867 1.22752C8.91953 1.68398 7.87987 2.83227 7.44152 5.12695C6.80019 5.32516 6.17315 5.51956 5.59377 5.69967C6.10835 3.94912 7.32812 1.09696 9.50083 1.09696ZM10.0221 11.3239C10.0221 11.3239 9.23876 10.9056 8.27915 10.9056C6.87166 10.9056 6.80114 11.789 6.80114 12.011C6.80114 13.225 9.96586 13.6901 9.96586 16.5337C9.96586 18.7712 8.54693 20.212 6.63342 20.212C4.33779 20.212 3.16281 18.7826 3.16281 18.7826L3.77746 16.7519C3.77746 16.7519 4.98483 17.7877 6.00258 17.7877C6.66773 17.7877 6.93836 17.2636 6.93836 16.8815C6.93836 15.2977 4.3416 15.2272 4.3416 12.6247C4.3416 10.4348 5.91395 8.31549 9.08725 8.31549C10.3099 8.31549 10.914 8.66618 10.914 8.66618L10.0221 11.3239ZM11.4991 3.87002C11.4991 3.78998 11.5001 3.71183 11.5001 3.62607C11.5001 2.87801 11.3962 2.27575 11.2295 1.79833C11.8984 1.88219 12.3444 2.64359 12.6312 3.51934C12.2948 3.62416 11.9127 3.74233 11.4991 3.87002Z"
    fill="black"
  />
</svg>
}
  href="https://help.shopify.com/en/manual/products/details/product-type"
>
  Learn more about Shopify product types
</Card>

<img alt="Product type filter" />

## Next step

Next we'll look at how to customise the framing of your artworks.

<Card title="Customisation: Framing" icon="circle-arrow-right" href="/customisation/frames">
  Learn how to customise the framing of your art products
</Card>


# Rooms
Source: https://docs.frameup.app/customisation/rooms

Choose a room for 'View in a room' mode

## Choose a room

Click the thumbnail with the <Icon icon="pencil" /> icon to open up the room selection panel.

<img alt="View in a room" />

Here you can select from a range of rooms. If you're using different artwork sizes (see <a href="/customisation/variants#automatically-create-a-size-rule">size variants</a>) we recommended checking each size to make sure it fits in the room.

<Info>
  More room options are available on the Advanced and Plus tiers with custom
  rooms possible with the Plus tier
</Info>

<img alt="Choose a room" />

## Next step

Next we'll look at how to customise the framing of your artworks.

<Card title="Customisation: Variants" icon="circle-arrow-right" href="/customisation/variants">
  Teach Frame Up how to interpret your size and framing variants
</Card>


# Variants
Source: https://docs.frameup.app/customisation/variants



## Introduction

Wall art is often sold with different framing and size options. On Shopify these are usually offered as product variants. Frame Up can understand these variants and show customers a matching artwork preview.

<Frame>
  <img alt="Variants" />
</Frame>

<Note>Your products should already have variants before continuing</Note>

## Variant rules

There are many different ways to configure your variants so we need to teach Frame Up how to understand them - we do this using Variant Rules.

Search for a product in the preview section. Choose a product that has variants.

Below the preview area you'll see all the product's variants listed:

<img alt="Variants overview" />

If a variant option is yellow that means no matching rule has been found.

<Note>
  Notice how the artwork frame is black. This is because in the Artwork
  Presentation section the frame material is set to black.
</Note>

### Automatically create a style rule

Let's set up a variant rule for the "Oak" option. To do this click "Create a variant rule".

This automatically creates a rule for us that we can see on the right side of the page.

<img alt="Create variant rule" />

The 'Oak' variant option is now green. On the right side of the page we can now select the appropriate style settings. In our case we want to set 'Frame Material' to 'Natural Grain' because it most closely matches the look of the frames we sell.

<img alt="New variant rule created" />

This process can then be repeated for your other style variants.

### Automatically create a size rule

Frame Up can automatically detect variants if they look like sizes, for example *12" x 16"*. To do this click “Create a variant rule”.

<img alt="Create size rule" />

This creates a single rule that detects all your size options.

<img alt="Size variants" />

### Creating rules manually

You can also create rules manually using the 'New variant rule' button at the bottom of the variant rules section. We recommend using the automated system above as it guarantees the rule will match the variant.

<Card title="Frame Up Support" icon="message-circle-question" href="mailto:support@frameup.app">
  Our support team is ready to help! Click here to e-mail us with any questions
  you have about Frame Up.
</Card>


# Introduction
Source: https://docs.frameup.app/index

Learn how Frame Up elevates art product pages

<img alt="Hero" />

## What is Frame Up?

Frame Up is a Shopify plugin that showcases your wall art products automatically. It does this by adding a frame to your artworks and placing them in a virtual room environment. This helps customers visualise your art on their own walls and explore all the size and framing options you offer.

Watch a video overview and try the interactive demos here: <a href="https://frameup.app">frameup.app</a>

<Card title="Next step: Quickstart" icon="rocket" href="/quickstart">
  Learn how to install Frame Up and customise it for your store
</Card>


# Quickstart
Source: https://docs.frameup.app/quickstart

Get Frame Up running on your website in under 5 minutes

## Install Frame Up

Click the link below to open the Shopify App Store, then click the "Install" button.

<Card
  title="Open the Shopify App Store"
  icon={
<svg
  width="21"
  height="24"
  viewBox="0 0 21 24"
  fill="none"
  xmlns="http://www.w3.org/2000/svg"
>
  <path
    d="M17.858 4.66109C17.7732 4.65442 15.9703 4.52005 15.9703 4.52005C15.9703 4.52005 14.7181 3.27742 14.5809 3.13924C14.5475 3.10589 14.5065 3.08302 14.4618 3.06873L13.5688 23.7018L20.6235 22.1695C20.6235 22.1695 18.0791 4.96889 18.0629 4.85168C18.0467 4.73351 17.9428 4.66871 17.858 4.66109Z"
    fill="black"
  />
  <path
    d="M14.0702 3.07527C14.0549 3.08003 13.7967 3.15913 13.3698 3.29159C12.9514 2.08802 12.2138 0.982611 10.915 0.982611C10.8788 0.982611 10.8426 0.984517 10.8054 0.986423C10.4357 0.498517 9.9792 0.286011 9.58373 0.286011C6.5591 0.286011 5.11444 4.06728 4.66084 5.98841C3.48586 6.35243 2.65108 6.61163 2.54435 6.64499C1.88873 6.85082 1.86776 6.87179 1.782 7.48929C1.7172 7.95719 0 21.2317 0 21.2317L13.2468 23.7141L14.1407 3.05907C14.114 3.06383 14.0892 3.06955 14.0702 3.07527ZM10.7063 3.98438C10.7063 4.03012 10.7063 4.073 10.7053 4.11588C9.96872 4.34363 9.1692 4.5914 8.36778 4.83916C8.81757 3.10195 9.66187 2.26336 10.3994 1.94699C10.5853 2.41298 10.7063 3.08194 10.7063 3.98438ZM9.50083 1.09696C9.63138 1.09696 9.76288 1.1408 9.88867 1.22752C8.91953 1.68398 7.87987 2.83227 7.44152 5.12695C6.80019 5.32516 6.17315 5.51956 5.59377 5.69967C6.10835 3.94912 7.32812 1.09696 9.50083 1.09696ZM10.0221 11.3239C10.0221 11.3239 9.23876 10.9056 8.27915 10.9056C6.87166 10.9056 6.80114 11.789 6.80114 12.011C6.80114 13.225 9.96586 13.6901 9.96586 16.5337C9.96586 18.7712 8.54693 20.212 6.63342 20.212C4.33779 20.212 3.16281 18.7826 3.16281 18.7826L3.77746 16.7519C3.77746 16.7519 4.98483 17.7877 6.00258 17.7877C6.66773 17.7877 6.93836 17.2636 6.93836 16.8815C6.93836 15.2977 4.3416 15.2272 4.3416 12.6247C4.3416 10.4348 5.91395 8.31549 9.08725 8.31549C10.3099 8.31549 10.914 8.66618 10.914 8.66618L10.0221 11.3239ZM11.4991 3.87002C11.4991 3.78998 11.5001 3.71183 11.5001 3.62607C11.5001 2.87801 11.3962 2.27575 11.2295 1.79833C11.8984 1.88219 12.3444 2.64359 12.6312 3.51934C12.2948 3.62416 11.9127 3.74233 11.4991 3.87002Z"
    fill="black"
  />
</svg>
}
  href="/components/columns"
>
  This link will take you to Frame Up's page on the Shopify App Store
</Card>

## Start free trial

Choose either a Basic or Advanced plan to start a free 10-day trial of Frame Up.

<img alt="Choose tier" />

## Onboarding

### Preview in the app

Before adding the plugin to your website let's preview the plugin with one of your products in the app.

On the left side of the app you'll find the "Preview" section. Use the search box to find and select one of your wall art products.

<Note>
  Your store should have at least one wall art product and its first image
  should be just the artwork with no frame or other background
</Note>

<img alt="Searching for a product" />

Below the search box you'll see a preview of how the plugin would appear on a website.

<img alt="Preview product" />

<Info>
  The plugin replaces your existing image gallery on your wall art product pages
</Info>

Try hovering the mouse (on desktop) or touching (on mobile) over the artwork
to view it from different angles. Also try clicking the "View in a room" button.

### Preview in the theme editor

To see how the plugin looks when integrated into your theme click "Open in Theme Editor". This opens the Shopify theme editor with the Frame Up plugin enabled.

<img alt="Open in theme editor" />

You should see that the plugin has replaced the standard image gallery. Sometimes third party themes have compatibility issues with Frame Up - if you don't see the plugin please <a href="mailto:support@frameup.app">contact us</a> and we'll find a solution for you.

<img alt="Theme editor with plugin activated" />

<Warning>
  Clicking "Save" in the theme editor enables the plugin on your live website.
  You probably don't want to do this yet!
</Warning>

<Note>
  The plugin may take a couple of seconds to appear in the theme editor but
  should appear instantly on your live website
</Note>

## Next step

You should now have an idea of how Frame Up works. Next we'll look at how to customise the plugin for your store.

<Card title="Customisation: Product Type" icon="circle-arrow-right" href="/customisation/product-type-filter">
  Learn how to enable Frame Up only for some of your products
</Card>


# Theme Integration
Source: https://docs.frameup.app/troubleshooting/theme-integration

Learn how to resolve theme integration issues

## Enabling the plugin

If you're having problems enabling the plugin via the app then it's also possible to enable it directly through the theme editor. Follow the steps below:

### 1. Open the theme editor

In Shopify admin, click "Online Store" in the left-side panel, then click "Customize" on your current theme.

<img alt="Artwork presentation" />

### 2. Navigate to an artwork product page

Search for a product that you've enabled for use with Frame Up. *See [Product Type Filter](/customisation/product-type-filter) for more information about enabling Frame Up only for specific product types.*

<img alt="Artwork presentation" />

### 3. Enable the plugin

Click the "App embeds" button - this is the third of the 3 buttons along the left side of the page. Search for Virtual Gallery (Frame Up) and enable the switch as pictured below.

<img alt="Artwork presentation" />

You should now see Frame Up working on your product pages! If everything looks good don't forget to click "Save" in the top right corner.

## Theme compatibility issues

Occassionally third party themes have compatibility issues with Frame Up. If the above steps haven't worked as you'd expect please [contact our support team](mailto:support@frameup.app) and we'll resolve the issue as quickly as possible.