Embed TisFile Studio

How it works

1. 1

   Photo to 3D

   In your dashboard, create a Studio item from one product photo. AI rebuilds it as an interactive 3D model with editable logo and text zones. No modelling, no photoshoot.

2. 2

   One line of code

   Every item gets its own embed link. Add your store's domain and paste the iframe onto your store. It runs on your own domain with no build step and no SDK to maintain.

3. 3

   Customers design it, you get the order

   Shoppers drop in their own logo, text, and artwork right in the viewer. Their personalised design lands in your inbox as a quote request.

Quick start

The simplest way to embed Studio is with an iframe. Copy this snippet and replace YOUR-VIEWER-SLUG with the slug of the item's viewer.

<iframe
  src="https://tisfile.com/embed/studio/YOUR-VIEWER-SLUG"
  width="100%"
  height="700"
  frameborder="0"
  allow="fullscreen"
></iframe>

Four words cover the model: an Item is the 3D product; its Design is the zones where shoppers may add their logo, text or artwork; its Viewer is the link and the embed code you paste; its Colours are the colourways shoppers can switch between. Every item mints its own viewer the moment its model finishes.

The ready-to-paste code sits on each item's page in your dashboard, and the Viewers page lists every link across your items. The design and the colourways stay in sync with your dashboard, so the code never needs updating.

Script it with the API

If you would rather convert a catalogue in code, or have a coding agent do it, the developer API covers the same path end to end: photos in, a viewer out, colourways, and the shopper's configuration handed to your own cart. Create a key in the Developer API panel on your billing page. It is shown once, so store it straight away.

curl https://tisfile.com/api/v1/account \
  -H "Authorization: Bearer tf_live_..."

The full reference, written to be read by people and coding agents alike, is llms-api.txt. Read it before you start: it names the few choices that cannot be undone, such as an item's goal, and the ones that cost a rebuild.

On Shopify? Skip the code

TisFile Studio is launching on the Shopify App Store. With the app installed, there is no snippet to paste at all:

• ·Import a product straight from your catalogue; its existing photos become the 3D model.
• ·Add the TisFile 3D Customizer block to your product template once, in the theme editor. Every product you publish after that just works.
• ·Published products also get an interactive 3D view with AR in their own photo gallery.
• ·Prefer a button? The TisFile Customize Button block opens the hosted portal instead of embedding.

Merchants who install from Shopify are billed for the same plan through Shopify billing; everything else on this page works the same.

Responsive embedding

To keep the viewer responsive, wrap the iframe in a container with a fixed aspect ratio.

<style>
  .tisfile-studio {
    position: relative;
    width: 100%;
    padding-bottom: 100%; /* 1:1 aspect ratio */
  }
  .tisfile-studio iframe {
    position: absolute;
    inset: 0;
    width: 100%;
    height: 100%;
    border: none;
  }
</style>

<div class="tisfile-studio">
  <iframe
    src="https://tisfile.com/embed/studio/YOUR-VIEWER-SLUG"
    allow="fullscreen"
  ></iframe>
</div>

Hosted portal (no iframe)

If you would rather not embed an iframe, link shoppers to a full-screen customizer that TisFile hosts. They personalise the product on our page and are returned to your store with their quote reference after submitting. You configure the portal, including which domains may open it, from the same viewer settings in your dashboard.

What shoppers can change

You decide, per zone, which tools each shopper gets. The options are:

• Spin and inspect

  Rotate the product freely to view it from any angle.

• Pick their colours

  Colour their own logo, text, or artwork, from a palette you allow.

• Upload a logo

  Drop in their own logo, with background removed automatically.

• Edit text

  Change the product's text while keeping its original style and finish.

• Whiteboard

  Draw or place their own artwork directly on a zone.

• Request a quote

  Send their personalised design to you as a quote request.

Shoppers never need an account and never pay to use the viewer.

How billing works

Studio is a monthly plan, priced in US dollars. Exactly two things are metered: 3D builds (turning photos into a model) and shopper customisations (a visitor personalising one with AI). Every plan includes a monthly build allowance, and every plan above the entry Colours tier includes a customisation allowance as well. Everything else, including colourways, designs, embeds, the hosted portal and quote requests, is unlimited on every plan. Every account can start a free 7-day trial of the Launch plan, once, with no card.

The merchant pays. When a shopper triggers an AI action in your embedded viewer (for example, composing an uploaded logo onto the product), it counts against your monthly customisations, never against the shopper. Simple actions such as spinning, plain text changes, and submitting a quote are free and uncounted. Going over an allowance is billed per use rather than blocked, so your shoppers never hit a wall. See pricing for the full breakdown.

Domain allowlist

For security, each viewer has a list of the domains it is shown on. Add the domains that are allowed to embed or open it (for example https://yourshop.com). If the list is left empty, only you can see the viewer, from your own TisFile dashboard, which is the safe default. You can update the list any time from the item page or the viewer settings.