# Credit
Source: https://help.mockspark.com/docs/billing/credit
Additional credit options outside of your subscription plan
If you go over the limits of your current subscription plan, you have two options: upgrade your plan or add credits to your app balance.
**Prerequisites** : Before you begin, make sure to see [Subscription Plans Guide](/docs/billing/subscription-plans).
Credits can be used to pay for services within MockSpark, but you'll need to have an active subscription to apply them.
All credit purchases are still processed through Shopify Billing.
## Add Credit
1. Click the profile icon in the top right corner.
2. Select **Pricing** from the dropdown menu.
Once you’re on the **Pricing** page, scroll to the **Credit** section to view your remaining credits or purchase additional credits.
# Purchases
Source: https://help.mockspark.com/docs/billing/purchases
Check your billing and purchase history with ease
1. Select **Billing** section from the top navigation bar.
2. In the dropdown menu, click on **Purchases**.
## Search
The search area in the **Purchases** section supports the following two filter options:
1. `Payment Charge Id`: The unique Payment Charge ID provided by Shopify after a payment is completed.
2. `Purchase Create At`: The date and time when the purchase was created. You can filter by a date range.
3. `Type`: Type of purchase. Supports both `Subscription` and `One Time`.
## Purchases Table
This table lists all your payment records, including subscriptions and one-time charges, making it easy to review and manage your billing at any time.
All charges are billed in USD
To review your billing details further, go to your **Shopify Admin**, then navigate to **Settings** and select **Billing**.
# Subscription Plans
Source: https://help.mockspark.com/docs/billing/subscription-plans
Choose a subscription plan so we can better serve your needs
A subscription plan is how MockSpark charges for its services, allowing Shopify merchants to pay a recurring fee to access the platform and take advantage of its features.
Our subscription plans are powered by the Shopify platform, making them easy and reliable for all Shopify merchants to use with confidence.
The subscription pricing model is a combination of time and usage-based subscriptions.
## How It Works
Each Shopify store can have only one active subscription to the MockSpark App. Merchants must approve the subscription, and any recurring charges are billed automatically.
If a merchant changes their subscription while their current plan is active, then they need to accept a new recurring app charge. The existing subscription is canceled and replaced by the new subscription after the merchant approves it. Charges and credits can be prorated, and charges can be deferred, when merchants move to a new plan depending on the subscription change.
When MockSpark App is uninstalled, Shopify automatically cancels the subscription. A credit isn't applied to cover the cost of the rest of the billing period. Merchants can reinstall and use the MockSpark App for the remainder of the billing period.
When a store's billing account freezes, associated MockSpark App subscriptions also freeze.
## Select a Subscription Plan
1. Click the profile icon in the top right corner.
2. Select **Pricing** from the dropdown menu.
After navigating to the **Pricing** page, scroll down to view the available subscription plans and choose the one that best fits your needs.
You can use a Shopify development store to activate any plan for free and explore or test our app.
## Cancel Your Subscription Plan
Since MockSpark’s subscription fees are managed through Shopify Billing, your subscription will be automatically canceled when you uninstall the MockSpark App from your Shopify admin.
When you cancel your subscription, all of your product data in MockSpark will remain unchanged. If you decide to use MockSpark again, simply reinstall the app and your data will still be there.
## About Products Fulfilled by Third Parties
Please note that for products fulfilled through third-party providers such as Printify and Printful, all production and shipping services are handled directly by those fulfillment platforms.
Our app facilitates product customization and order transfer, but it does not include third-party production or delivery fees in your Mockspark subscription. Any costs related to manufacturing, shipping, or additional services from Printify or Printful will be charged through your connected accounts on those respective platforms.
# Usages
Source: https://help.mockspark.com/docs/billing/usages
View your fee details and usage
1. Select **Billing** section from the top navigation bar.
2. In the dropdown menu, click on **Usages**.
## Search
The search area in the **Usages** section supports the following two filter options:
1. `Date Issued`: The date and time when the service was used. You can filter by a date range, with support for searching up to the most recent 90 days
2. `Fee Type`: The Fee Type associated with the service. Supports both `Subscription plan` and `Credit`.
You can apply multiple filters at once to refine your search. Click the **Search** button to view Usages that match your selected criteria.
## Usages Table
This table shows which services are free, which are paid, and the cost of each paid service.
All fees are billed in USD
Each row in the table represents a single usage record.
# Connect Your Etsy Shop
Source: https://help.mockspark.com/docs/connections/etsy/connect
Authorize Mockspark from Etsy, manage several shops, and disconnect when you need to
Connecting takes about a minute. You will be sent to Etsy to approve the connection, then brought straight back.
## Connect a Shop
Log in to [app.mockspark.com](https://app.mockspark.com), open **Connections** in the top navigation, and choose **Etsy**.
Click the **Connect Etsy shop** card.
A short notice appears before you leave Mockspark. Read it and click **Continue to Etsy**.
Etsy now asks you to allow the connection and lists what the app will be able to do. If you want to know what each of those permissions is used for, [How Mockspark Works with Etsy](/docs/connections/etsy/overview) explains them one by one. Click **Grant access**.
Etsy sends you back to Mockspark and your shop appears as a card.
That is the whole setup. There is nothing to install in your Etsy shop and no theme or template to edit.
## Connecting More Than One Shop
Run several Etsy shops from one Mockspark account by clicking **Connect Etsy shop** again and authorizing the next one. Each shop gets its own card.
One shop is marked **Default**. When you create a new product, Mockspark assumes you mean the default shop, though you can switch shops on the publish form while the product is still a draft. To change which one is the default, hover over a card and click **Set as default**.
Once a product has been published to a shop, you cannot move it to a different shop. Pick the right shop before you publish.
## When a Shop Says "Reconnect Required"
Etsy access tokens expire and Mockspark refreshes them for you in the background. Sometimes that fails, usually because you removed the app from your Etsy account, or you changed your Etsy password.
When that happens the card shows a red **Reconnect required** tag in place of the usual green **Available** status, and order syncing for that shop stops.
To fix it, hover over the card and click **Reconnect**, then approve on Etsy again. Nothing is lost. Your products, listings, and past orders stay exactly where they were, and syncing picks up again.
## Disconnecting a Shop
Hover over the card and click **Disconnect**.
This stops Mockspark from syncing orders for that shop. Listings already on Etsy stay live and keep selling, so if you want them gone, remove them in Etsy.
Disconnecting in Mockspark does not revoke access on Etsy's side. To cut off access completely, go to Etsy Shop Manager, open **Apps**, switch to the **Connected apps** tab, and click **Disconnect** next to Mockspark Product Personalizer.
## Next
Turn a designed product into a real Etsy listing.
***
The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
# Introduction
Source: https://help.mockspark.com/docs/connections/etsy/introduction
Design print-on-demand products, publish them to Etsy, and let Mockspark handle the production files
Mockspark is a design and fulfillment tool for print-on-demand sellers. You build a product, place your artwork on it, publish it to your Etsy shop, and Mockspark turns each order into a print-ready file and sends it to your print provider.
Your shop stays yours. Mockspark does not change how you sell, price, or talk to buyers on Etsy. It handles the part between "a buyer placed an order" and "the printer has the right file".
## What You Can Do
Authorize Mockspark from Etsy, and connect more than one shop if you run several.
Push a designed product to Etsy as a real listing, with variants, prices, and photos.
Give buyers a designer of their own, then produce exactly what they made.
Orders arrive on their own, get turned into print files, and go out to your print provider.
## Before You Start
Three things need to be in place.
Your shop has to be open and finished with Etsy's payment setup. If you are still partway through it, Etsy will not let any app create listings in your shop, including this one. You can check by opening your Shop Manager. If Etsy keeps sending you back to the payment setup screen, that step is not done yet.
Etsy requires print-on-demand sellers to declare who physically makes their items. Publishing will fail without one, and Etsy's error message for this is famously unhelpful. Etsy's API cannot create a production partner, so you add it yourself in Shop Manager. [Publish a Product to Etsy](/docs/connections/etsy/publish) shows you where and what to write.
Sign up at [app.mockspark.com](https://app.mockspark.com) with your email address. Etsy sellers do not install anything from the Etsy marketplace, so this is a normal account signup.
## How the Pieces Fit
If you want the whole picture before you touch anything, including what Mockspark reads from your shop and why, read [How Mockspark Works with Etsy](/docs/connections/etsy/overview) first. It takes about five minutes.
If you would rather get going, start with [Connect Your Etsy Shop](/docs/connections/etsy/connect).
***
The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
# Etsy Orders and Fulfillment
Source: https://help.mockspark.com/docs/connections/etsy/orders
How paid Etsy orders reach Mockspark, become print files, and get shipped
Once your listings are live, orders take care of most of themselves. This page covers what arrives, what you do, and the two places Etsy behaves differently from what you might expect.
## Orders Arrive on Their Own
Mockspark checks each connected shop for new paid orders every 15 minutes, so an order usually appears within a quarter of an hour of being paid.
You do not need to import anything or press a sync button. If an order is paid, it is coming.
Only paid orders are picked up. Etsy carts, drafts, and unpaid orders are ignored.
## Order Statuses
An order moves through these on its way out the door.
| Status | What it means |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Generating** | Mockspark is building the print-ready file. This usually takes seconds |
| **Ready to fulfill** | The file is done. The order is waiting for you to send it to your print provider |
| **Being fulfilled** | You sent it, and your print provider has it |
| **Fulfilled** | Shipped, with tracking sent back to Etsy |
| **Unfulfillable** | Nothing producible came with the order. Almost always a missing or invalid customization ID. See [personalization](/docs/connections/etsy/personalization#when-a-buyer-skips-the-id) |
| **Canceled** | The order was fully refunded on Etsy, or you cancelled it in Mockspark |
## Sending an Order to Production
Open an order that is **Ready to fulfill** and click **Send to Fulfill**. Mockspark passes across the print file, the variant, the buyer's shipping address, and the quantity.
This step is yours on purpose. Production costs money, so nothing goes out until you say so.
Your print provider bills you directly using the account you connected. Mockspark does not add a charge on top and does not take a cut of the order.
Your print provider account has to be connected first. See [Printful](/docs/connections/printful) or [Printify](/docs/connections/printify).
## Tracking Goes Back to Etsy
When your print provider ships, Mockspark marks the order as shipped on Etsy and sends the tracking number over. Etsy then notifies the buyer, the same as it would for any other order.
### The One Exception: Orders with More Than One Item
Etsy applies shipping updates to a whole order rather than to individual items. If a buyer bought three things in one order, there is no way for an app to mark only one of them as shipped.
Because of that, Mockspark does not send shipping updates for Etsy orders containing more than one item. It would either notify the buyer too early or mark items as shipped that have not been.
For these orders, **mark the order as shipped in Etsy yourself** once everything has gone out. Mockspark shows a reminder on any order this applies to, so you will not have to remember on your own.
Single-item orders, which is most print-on-demand traffic, are fully automatic.
## Refunds and Cancellations
If you fully refund a buyer on Etsy, Mockspark notices on its next check and marks the order **Canceled**.
Two things worth knowing:
**Partial refunds are not tracked.** If you refund part of an order, Mockspark leaves it alone, since the order is still going ahead in some form.
**Cancelling does not recall production.** If you already sent the order to your print provider, cancelling in Mockspark does not stop it. Cancel it in your print provider's dashboard too, and do that quickly, because once production starts you are paying for it.
Refunding a buyer always happens on Etsy. Marking an order **Canceled** in Mockspark changes the status in Mockspark only. No money moves.
## Common Questions
Give it 15 minutes. If it still has not arrived, check the [connections page](/docs/connections/etsy/connect) for a **Reconnect required** tag, which stops syncing for that shop until you reauthorize.
The buyer did not supply a usable customization ID. Send them the design link from the order page. [Full walkthrough here](/docs/connections/etsy/personalization#when-a-buyer-skips-the-id).
Yes. Open the order and change the design before sending it to production. Mockspark rebuilds the print file. Once the order is with your print provider, changes have to be handled there.
Print providers validate addresses and will reject ones that do not add up. Message the buyer on Etsy for a corrected address, then update it before sending the order to production.
***
The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
# How Mockspark Works with Etsy
Source: https://help.mockspark.com/docs/connections/etsy/overview
The full path from your design to a shipped Etsy order, and what Mockspark reads from your shop
This page explains what happens behind the scenes. Read it if you want to know where your data goes before you connect your shop, or if you are reviewing this app on behalf of Etsy.
## The Full Path
```mermaid theme={null}
flowchart TD
A[You design a product in Mockspark] --> B[You publish it to your Etsy shop]
B --> C[Etsy listing goes live]
C --> D[A buyer places an order on Etsy]
D --> E[Mockspark picks up the paid order]
E --> F[Mockspark builds the print-ready file]
F --> G[You send the order to your print provider]
G --> H[Provider prints and ships to the buyer]
H --> I[Mockspark sends the tracking number back to Etsy]
```
A few notes on the steps that surprise people.
**Mockspark checks Etsy for new orders every 15 minutes.** Etsy does not push order notifications to apps the way some platforms do, so Mockspark asks Etsy for recent paid orders on a schedule. A new order usually shows up in Mockspark within 15 minutes of being paid, sometimes sooner.
**Print files are built for you, not by you.** Once an order arrives, Mockspark renders each print area at full resolution and stores the file. You do not need to export anything.
**Sending to the print provider is a decision you make.** Mockspark prepares the order and waits. Nothing goes to Printful or Printify until you send it.
## What Mockspark Reads from Your Etsy Shop
When you connect your shop, Etsy shows you a permission screen. The table below lists every line on that screen, in Etsy's own wording and in the order Etsy shows it, so you can read the two side by side. Mockspark asks for nothing beyond these.
| What Etsy asks for | What Mockspark does with it |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Connect to your account | Identifies which Etsy account approved the connection, so the shop can be linked to your Mockspark account |
| see billing and shipping addresses | Passes the buyer's delivery address to your print provider so the parcel can be addressed |
| Read your user profile | Etsy shows this line for the email permission. Any contact details that come with an order are displayed on the order page, so you can reach the buyer yourself if something needs sorting out. Mockspark never emails your buyers and never uses these details for marketing |
| delete listings | Removes a draft listing that Mockspark itself created if publishing fails partway through. Listings you created yourself are never deleted |
| see all listings (including expired etc) | Checks whether a listing Mockspark published still exists before updating it |
| create/edit listings | Publishes your products, and updates prices, photos, and variants when you republish |
| see private shop info | Reads your shipping profiles, return policies, production partners, processing times, currency, and the country you ship from, so the publish form can offer you real choices instead of blank fields |
| update shop | Creates one shipping profile, and only if you ask for it while publishing. Mockspark never edits shipping profiles you made yourself |
| see all checkout/payment data | Brings paid orders into Mockspark so they can be produced. Mockspark reads what was ordered and what the buyer paid. Card and bank details are not part of what Etsy's API returns, so Mockspark never receives them |
| update receipts | Marks an order as shipped and sends the tracking number back to Etsy after your print provider ships it |
## What Mockspark Does Not Do
* It does not read or reply to your Etsy messages.
* It does not touch listings you created outside Mockspark.
* It does not change your prices, policies, or shop settings on its own.
* It does not issue refunds or cancel orders on Etsy. If you need to refund a buyer, you do that in Etsy.
* It does not scrape Etsy. Everything it does goes through the official Etsy API.
## Where Your Designs Live
Your artwork, mockups, and finished print files are stored by Mockspark. Etsy only ever receives the finished listing photos you publish. Print providers only receive the print file for orders you choose to send them.
## Disconnecting
You can disconnect a shop from Mockspark at any time, which stops order syncing right away. To cut off access completely, also revoke the app in Etsy Shop Manager under **Apps** then **Connected apps**. [Connect Your Etsy Shop](/docs/connections/etsy/connect) covers both steps.
## Next
Authorize Mockspark and get your shop linked.
***
The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
# Let Buyers Personalize Your Listings
Source: https://help.mockspark.com/docs/connections/etsy/personalization
Give Etsy buyers their own designer, and produce exactly what they made
Personalization lets a buyer design their own version of your product before they buy it. They open a designer, place their text or image, submit it, and you produce that exact design.
## Why It Works This Way
Etsy does not let apps put a custom designer inside a listing page. The only field Etsy gives you for buyer input is **Personalization**, and it accepts plain text.
So Mockspark works with what Etsy allows. The Personalization field carries a link to the designer and collects a short ID that points back to the design the buyer made. It takes the buyer one extra copy and paste, and everything else is automatic.
## Turning It On
On the publish form, switch on **Let buyers customize this design**, then publish.
Mockspark adds a required personalization question to your Etsy listing:
* The question is labelled **Customization ID**
* The instructions read `Open https://app.mockspark.com/guest/customize?p=etsy&ref= to design, then paste your ID here`
* The field accepts up to 36 characters, which is exactly the length of one ID
The link is unique to that listing, so the designer always opens the right product.
Turning the switch off and republishing removes the personalization question from the listing.
## What the Buyer Does
The buyer copies the address from the personalization instructions and opens it. No account and no login.
They pick a variant, add text or upload an image, and see it on the product as they go.
When they are happy, they click **Submit customization**. Mockspark saves the design and shows a 36-character ID with a copy button.
They return to your listing, open **Add personalization**, paste the ID into the **Customization ID** box, and add to cart as normal. The character counter reads 36 of 36 when the ID is complete.
When the order reaches Mockspark, it reads the ID, finds the design, and builds the print file from it. You do not need to match anything up by hand.
## When a Buyer Skips the ID
Some buyers will type a message into the field, or paste something that is not an ID, or buy without designing at all. Mockspark cannot produce anything in that case, so the order arrives marked **Unfulfillable** in your order list.
Open it and the page tells you exactly what went wrong and what the buyer actually typed, so you know whether they misread the instructions or skipped them.
You have a way out. Click **Copy redesign link**, then send that link to the buyer through Etsy messages. It opens the designer locked to the size they already paid for, so they cannot accidentally design for the wrong variant. Once they submit, the order becomes producible and moves on as normal.
Nothing is charged for an order in this state. It sits on hold until the buyer supplies a design that matches what they ordered.
If the buyer never responds, click **Cancel order item** and refund them on Etsy. Cancelling in Mockspark only updates the status there, it does not refund anyone.
Refunds always happen on Etsy. Mockspark never moves money and never contacts your buyers.
## Good Listing Copy Helps
Buyers move faster when the listing tells them what is coming. A line in your description such as "Click the link in the Personalization box to design your item, then paste the ID it gives you" cuts down on orders that arrive without an ID.
## Next
How personalized and standard orders both get produced.
***
The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
# Publish a Product to Etsy
Source: https://help.mockspark.com/docs/connections/etsy/publish
Add a production partner, fill in the Etsy settings, and push your product live as a real listing
Publishing is the last step of building a product. If you have not built one yet, start with [Products](/docs/products/products) and [Personalizer](/docs/products/personalizer), then come back here.
## First, Add a Production Partner
Etsy requires every print-on-demand seller to declare who physically makes their items. Without one, Etsy refuses to create the listing, and the error it returns is `Oh dear, you cannot sell this item on Etsy`, which sounds like your shop is banned. It is not. It only means the production partner is missing.
Etsy's API has no way to add a production partner, so this is something you do once, by hand, in your Etsy account.
In Etsy Shop Manager, go to **Settings** then **Partners you work with**, and click to add a partner.
Enter the company that actually prints and ships your products. If you fulfill through Printful, that is Printful. If you fulfill through Printify, that is Printify. Set **Location** to where that company produces your items.
Name the printer, not your design software. Etsy defines a production partner as the outside company that physically makes the item. Naming a tool instead of the printer counts as an inaccurate disclosure, and the risk falls on your shop.
This description is shown to buyers, so keep it clear and honest. Say that they print your designs and ship the orders. Something like:
> I create all the designs myself. This partner prints them onto the finished products, packs and ships each order directly to my customers.
Avoid vague lines like "they help with my shop". Etsy wants buyers to understand the arrangement.
**More about your partner** has three dropdowns. Etsy keeps these answers internal, so buyers never see them.
**Why do you work with this partner?** Most print-on-demand sellers pick *I don't have the technical ability or equipment to make it entirely by myself*, which is the honest answer if you do not own a printer.
**What is your role in the design process?** Pick *I design everything myself* if the artwork is yours.
**What is your partner's role in the production process?** Pick *They do everything for me*. Printful and Printify print your design, pack the order, and ship it straight to your buyer. The item never passes through your hands, so the other options do not apply: you are not assembling components, altering a finished product, or adding your own packaging.
That answer does not take credit away from you. The design question above already records that the artwork is yours. Together the two answers say what is actually true, which is that you design everything and your partner produces everything.
Save when you are done.
You only do this once per shop. After it is saved, it appears in Mockspark's publish form for every product.
## Fill In the Etsy Settings
Back in Mockspark, open your product. Building a product runs in three steps, shown along the bottom of the page.
Steps 1 and 2, the product details and the mockups, work the same whichever platform you sell on. [Products](/docs/products/products) walks through both.
Everything below is **Step 3, Publish to store**, which is where the Etsy settings live.
### Shop and Platforms
**Store** is the Etsy shop this product will be published to. You can switch shops while the product is still a draft. Once it has been published, the shop is locked.
**Sales platform** and **Fulfillment platform** are shown for reference. They come from how the product was created.
### Production Partner
Pick the partner you added earlier. This field is required, because Etsy rejects the listing without it.
If the dropdown is empty, the partner has not saved on Etsy's side yet. Add it, then reload this page.
### Store Currency and Weight Unit
**Store currency** should match the currency your Etsy shop sells in. Prices you set on the variants are read in this currency, so getting it wrong produces prices that are off by a lot.
**Weight unit** only matters if your print provider needs shipping weights. Leave it as **No weight** if you are not sure.
### Etsy Category
Mockspark preselects a category based on the product type, so most of the time you can leave it alone. Change it if the guess is off, since the category affects where buyers find your listing on Etsy.
### Etsy Shipping Profile
Etsy handles shipping costs through shipping profiles that live in your shop.
If you already have profiles, the dropdown lists them. Pick the one you want and Mockspark attaches it to the listing.
If your shop has none yet, the dropdown holds a single extra option instead: **Mockspark Shipping (free shipping)**. Choosing it tells Mockspark to create that profile in your Etsy shop as part of publishing. It is a real profile, so it shows up in your Etsy shipping settings afterwards and you can edit it there like any other.
Free shipping means the buyer pays nothing for delivery. It does not mean delivery is free. Your print provider still charges you for shipping, and that cost comes out of your margin. Price your items with that in mind, or set up your own shipping profile in Etsy instead.
The profile is created with your shop's own ship-from country, taken from your Etsy settings. If that country uses postal codes, Etsy requires one and does not share it through the API, so a postal code box appears under the dropdown and Mockspark asks you to fill it in once.
### Etsy Return Policy
Optional. Pick one of your shop's return policies if you have them.
Mockspark does not create return policies for you, because a return policy is a promise you make to buyers and that should be your wording, not ours. You can add one in your [Etsy shop policy settings](https://www.etsy.com/your/shops/me/policy-settings) and reload the page.
### Processing Time
You will notice there is no field for this. Mockspark sets processing time to **2 to 5 days** on every listing it publishes, which reflects how long print-on-demand production actually takes. If your shop already has a matching profile, Mockspark reuses it rather than creating another one.
### Buyer Personalization
Leave this off to sell a fixed design. Turn it on to let buyers make their own version before they buy. [Let Buyers Personalize Your Listings](/docs/connections/etsy/personalization) covers how that works from both sides.
### Variants
Set the price and availability for each variant. Prices are in the store currency you chose above.
## Publish
Click **Done & Publish**. Mockspark creates the listing on Etsy, uploads your photos, sets up the variants, and activates it.
When it finishes you get the listing URL and a **Check on Etsy** link that opens the live listing, so you can see what buyers see.
If something fails partway through, Mockspark removes the half-built draft it created so you do not end up with orphaned listings cluttering your shop. Fix what the error points at and publish again.
## Updating a Published Product
Change the design, prices, or photos in Mockspark and publish again. Mockspark updates the existing listing instead of creating a second one.
If you deleted the listing on Etsy in the meantime, Mockspark notices and creates a fresh one.
## When Publishing Fails
This is Etsy's message for a missing production partner. It is not about your shop's selling privileges. Add a production partner as described at the top of this page.
Mockspark caught the same problem before sending it to Etsy. Same fix.
Pick a profile, or choose **Mockspark Shipping (free shipping)** to have one created.
Etsy's category list failed to load. Reload the page. If it keeps happening, your shop connection may need reauthorizing. Check the [connections page](/docs/connections/etsy/connect) for a **Reconnect required** tag.
## Next
What happens after a buyer places an order.
***
The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
# Printful
Source: https://help.mockspark.com/docs/connections/printful
Seamlessly link your Printful store to streamline fulfillment
Once you've completed a quick setup, you’ll be able to create and publish **Printful** products directly from our platform. You can also sync orders to **Printful** for automatic production and fulfillment. This helps reduce manual work, so you can focus your time and energy on growing your business.
In the following steps, we’ll walk you through the **Printful** integration process to help you launch your print-on-demand business quickly and easily.
## Generate a New Token
Go to [Printful Developers](https://developers.printful.com/login) and select **Sign in to Printful**.
After logging in successfully, select **Tokens** from the sidebar.
On the `Your tokens` page, click the **Add new token** button in the top right corner.
On the `Add new token` page, fill out the following fields:
1. In the `Token name` field, enter a **Name** that helps you quickly identify the purpose of the token, such as `"MockSpark"`.
2. In the `Contact email` field, enter your primary **Email** address.
3. In the `Expiration date` field, set how long the **Token** should remain active. Once the token expires, it will no longer be usable. We recommend choosing the longest duration available.
The maximum expiration date supported by Printful is two years. they expire after that timeframe and you will need to generate a new one to replace it.
Next, follow these steps:
1. In the `Access level` field, switch to the **A single store** option, then select the **Printful Store** you want to connect to MockSpark from the dropdown menu.
2. In the `Scopes` section, check **all** available permissions.
3. Click **Create new token** to complete the process.
Once the token is created, scroll down to the `Access key` section at the bottom of the page. You will see your newly generated token there. Copy the **Token** to your clipboard.
The Token from Printful is only shown once at the time it is created, so make sure to store it securely.
## Connect to MockSpark
After you've received your Printful API token, go back to the **MockSpark** dashboard.
1. Select **Connections** section from the top navigation bar.
2. In the dropdown menu, click on **Printful**.
3. After the page loads, click **New store** on the screen.
On the page for connecting a new Printful store, you’ll need to complete the following settings:
1. In the **API Token** field, paste the token you copied from Printful.
2. Click the **Test this API Token** button to make sure the token is correctly formatted and working properly.
3. After confirming that the API token is set up correctly, go to the **Store** field and select the Printful store you want to connect.
4. Once everything is set up, click **Save** to complete the connection to your Printful store.
After saving, you’ll see the store you just connected listed on the Printful Stores page.
When you hover over the store card, you'll see options to edit or disconnect the store.
If a printful store is set as the default, all bulk fulfillment order-items will be processed through that store.
# Printify
Source: https://help.mockspark.com/docs/connections/printify
Seamlessly link your Printify store to streamline fulfillment
Once you've completed a quick setup, you’ll be able to create and publish **Printify** products directly from our platform. You can also sync orders to **Printify** for automatic production and fulfillment. This helps reduce manual work, so you can focus your time and energy on growing your business.
In the following steps, we’ll walk you through the **Printify** integration process to help you launch your print-on-demand business quickly and easily.
## Generate a New Token
Go to the [Printify website](https://printify.com/) and click **Log in** at the top of the homepage.
1. After logging in to your **Printify** account, go to the **Account** section in the sidebar.
2. From the dropdown menu that appears, select **Connections**.
Once you're on the Connections page, click the **Generate** button to create an API token for MockSpark.
1. In the `Token name` field of the dialog box, enter a **Name** for your token. Choose something that helps you easily identify its purpose or which service it's for, such as `"MockSpark"`.
2. Under `What sort of scopes do you need?`, select **All scopes(full access)**.
3. Click the **Generate Token** button.
API tokens are valid for one year, they expire after that timeframe and you will need to generate a new one to replace it.
After the token is successfully created, it will appear in the dialog box. Click **Copy to clipboard** to save it.
The API Token from Printify is only shown once at the time it is created, so make sure to store it securely.
## Connect to MockSpark
After you've received your Printify API token, go back to the **MockSpark** dashboard.
1. Select **Connections** section from the top navigation bar.
2. In the dropdown menu, click on **Printify**.
3. After the page loads, click **New store** on the screen.
On the page for connecting a new Printify store, you’ll need to complete the following settings:
1. In the **API Key** field, paste the token you copied from Printify.
2. Click the **Test this API Key** button to make sure the token is correctly formatted and working properly.
3. After confirming that the API token is set up correctly, go to the **Store** field and select the Printify store you want to connect.
If you want to align the shipping methods used in your Shopify store with those available through Printify, you can enable the option under **Send Shipping Method to Fulfill**. Then, use the **Shipping Method Match** section to map the shipping options from your store to the corresponding fulfillment methods on Printify.
The **Send Shipping Method to Fulfill** setting is optional.
Enabling the **Send Shipping Method to Fulfill** option can help reduce your operating costs. However, it's important to be familiar with the pros and cons of different shipping methods before using this setting. If you're not sure about the differences, it's perfectly fine to leave this option turned off for now.
1. Once everything is set up, click **Save** to complete the connection to your Printify store.
After saving, you’ll see the store you just connected listed on the Printify Stores page.
When you hover over the store card, you'll see options to edit or disconnect the store.
If a printify store is set as the default, all bulk fulfillment order-items will be processed through that store.
# Installation Guide
Source: https://help.mockspark.com/docs/get-started/installation-guide
Step-by-step instructions for installing the Shopify app and enabling it in your store theme.
# Install the Shopify App
Go to the [Shopify App Store](https://apps.shopify.com/) and type `mockspark` into the search bar at the top. Find the app called **Mockspark Product Personalizer**, then click to open its details page and select Install.
Shopify will redirect you to your store’s admin page, where you can review the permissions required by the app. Click the **Install** button to begin installation.
If the process completes without any issues, Mockspark will be successfully added to your Shopify store.
# Enable the App on Your Theme
After you’ve installed the **Mockspark Product Personalizer** app from the [Shopify App Store](https://apps.shopify.com/mockspark), just follow a few simple steps to enable the app in your current **Online Store Theme**. This will complete the setup and connect Mockspark with your Shopify store.
1. Log in to your **Shopify admin** and navigate to **Sales channels** on the left sidebar. Click on **Online Store**, and you’ll be taken to the `Themes` page by default.
2. Find your current `Online Store theme` and click the **Customize** button on the right side. This is where you’ll make a few setup changes to enable the app.
### Enable the App Embed
1. On the `theme customization` page, click the third icon in the left-hand sidebar to switch to the App Embeds panel.
2. In the `App Embeds` panel, locate the toggle for **Mockspark** and turn it on to enable the app.
### Add the Design Button
After enabling the `Mockspark App Embed`, the next step is to add the `Mockspark design button` to your product detail pages.
1. At the top of the `theme customization` page, click the dropdown that says **Home page**.
2. From the dropdown menu, select **Products**.
Click on **Default product** to open the template editor for the product detail page.
The name of the product detail page template may vary depending on the theme you're using. If you're using a paid third-party theme, we recommend reaching out to the theme developer for guidance.
In the `product detail` page template, choose a spot where you’d like the `Mockspark design button` to appear. A common placement is just above the Add to Cart button.
Move your cursor to the area where you want to add the button. A blue interactive highlight will appear on the screen. Click the plus() icon to insert the element.
In addition to visually adding the `Mockspark design button` within the product detail page template, you can also add it through the **Sections** panel.
Just pick the way that works best for you.
1. Click the first icon in the left-hand sidebar to switch to the **Sections** panel.
2. Under the **Template** module, select **Product information**.
3. In the expanded list, find **Buy buttons**, then right-click on it.
4. From the context menu, select **Add block before** to insert the button above the Buy buttons section.
1. Once you've selected the insertion point, a dialog box will appear on the screen. In the dialog box, switch to the **Apps** tab.
2. After switching to the `Apps` tab, scroll down and select the **Mockspark design button**.
1. Now, in the product detail page template, you'll see the **Mockspark design button** we just added. Select the button, which is labeled `Customize` by default.
2. After selecting the Mockspark design button, the **settings panel** will appear on the screen. From here, you can customize the button’s **style** to better match your store’s theme and overall look. You can also change the **text** that appears on the button.
The Mockspark Design button settings panel may appear on either the left or right side of the screen, depending on the width of your current display.
3. After you finish configuring the button, make sure to click the **Save** button in the top right corner of the page. Otherwise, your changes will not be saved.
That’s it! You’ve successfully enabled the **Mockspark Product Personalizer** app in your current Online Store theme. To exit the theme editor, click the **Exit** button in the top left corner of the page.
# Next steps
If everything went smoothly, you’ve successfully installed and enabled Mockspark. Now it’s time to create and publish your first customizable product.
Let’s get started:
Start selling your customizable products in minutes
# Introduction
Source: https://help.mockspark.com/docs/get-started/introduction
Welcome to Mockspark Help Center!
Mockspark Product Personalizer is an app designed specifically for **Shopify** merchants.
Boost your Shopify store’s sales with **Mockspark Product Personalizer**. Effortlessly create stunning product mockups and offer customizable print-on-demand products. Deliver an engaging design experience to your customers and turn your Shopify store into a customization powerhouse. Perfect for print-on-demand, apparel, and personalized gift products.
Here you’ll find resources, guides, and support to help you get the most out of Mockspark.
## New to Mockspark?
Start here to quickly install your app and learn how to use its key features.
Get your docs set up locally for easy development
Start selling your customizable products in minutes
## Browse by Category
Explore topics by category to find answers fast.
# Quick Start Guide
Source: https://help.mockspark.com/docs/get-started/quickstart
Start selling your customizable products in minutes
This quickstart guide will walk you through the process of creating and publishing a customizable product to your Shopify store in just a few minutes.
By the end of this guide, you will have a shop that can meet customers' customization needs.
**Prerequisites** : Before you begin, make sure to [install the Shopify App](/docs/get-started/installation-guide#install-the-shopify-app) and [enable the App on your Theme](/docs/get-started/installation-guide#enable-the-app-on-your-theme).
## Log In to the MockSpark Dashboard
Please visit and log in to our dashboard at [app.mockspark.com](https://app.mockspark.com/)
1. Log in using your Shopify store domain.
2. Click **Login** to sign in. Once you're logged in successfully, you'll be redirected to the dashboard's overview page.
Go to the **Products** section from the top navigation bar.
## Create a Customizable Product
In MockSpark, there are two ways to create customizable products:
1. Import a **Third-Party Fulfilled Product**.
2. Create a **Seller-Fulfilled Product**.
This Quickstart tutorial walks you through the first method: import a **Third-Party Fulfilled Product**.
To explore more about customizable product, visit [Products tutorial](/docs/products/products).
Click the **Import Product** button.
1. Choose a fulfillment platform you'd like to use, such as `Printify`.
2. Choose a product you want to sell, such as `T-shirt`.
1. Choose a provider for this product or simply go with the default option if you prefer.
2. Click **Import** to add the product to your product library.
### Step 1: Edit Basic Details
After the product is successfully imported, you'll be automatically redirected to its edit page. Here, you can customize the basic product details such as the title, description, and variants. However, for the Quickstart tutorial, we recommend keeping the default information provided by the fulfillment platform for now.
Click **Next** to proceed to the next step.
### Step 2: Create Mockups
In Mockspark, the **Mockup** is a core concept at the heart of our customization features. Every design function for customizable products is built around mockups.
A customizable product lets you group different variants into separate mockup groups. This is an advanced feature that’s especially helpful when you want to display each color or style with its own specific mockup. But to keep things simple in this quickstart guide, we'll apply all variants to a single mockup group for now.
To explore more about mockups, visit [Products tutorial](/docs/products/products).
In this guide, we’ll walk you through creating two mockups (one for the front and one for the back of your product) within the default mockup group.
Click **New Mockup** to open the Mockup Creator and build a mockup for your product.
To create a mockup, begin by clicking the button shown in the image below to upload a product photo.
Select or upload a front-facing image of the product.
In addition to using product images provided by your fulfillment platform, you also have the option to upload your own product photos. However, for this Quickstart guide, we’ll begin by using the default images from the fulfillment platform.
Click the **Using this image** button.
Click on the **Print Areas** section in the right-hand panel.
Click the **Add Print-Area**.
1. Select the appropriate front-facing Print Area based on its name, and make note of its aspect ratio.
2. Click **OK** to add this Print Area to your mockup.
Drag each of the 4 corners of the Print Area to the appropriate position on the product image.
In the Print Areas section of the right-hand panel, change **Mesh Warp** from **2D** to **3D**.
In `3D Mesh Warp` mode, the Print Area’s 4 corner points will be replaced with a 4x4 grid, giving you 16 adjustable control points.
Using the Print Area’s aspect ratio as a guide, adjust the control points to reshape the Print Area. This helps create a more realistic and natural-looking product mockup.
If your product is `White`, we recommend changing the **Blending Mode** from **Normal** to **Multiply** in the Print Areas section on the right-hand panel. This will help enhance the mockup’s visual appearance for a more realistic effect.
For the best results, we recommend setting the Print-Area's `Blending Mode` to `Multiply` only on **light-colored products**.
The `Multiply blend mode` creates darker colors by multiplying the base color with the blend color. In this mode, white areas in the blend layer become completely transparent and don’t affect the layers beneath, while black areas remain fully visible. It always darkens the image and never makes it lighter.
Click the **Preview** button to open the Personalizer and preview the current mockup.
Test your product in the Personalizer:
1. In the Print Areas panel on the right, select the print area labeled `front_dtg` to start designing.
2. Use the Elements panel on the left to add a design element (such as an image or text) to the canvas.
3. Adjust your design on the canvas and review the product preview in the bottom-left corner to see if it looks the way you want.
4. Click **Back** to return to the Mockup Creator.
If you’re happy with how your mockup looks, click the **Save** button to save your mockup.
We’ve already created a Print Area for the front of the product, now let’s set one up for the back.
Select or upload a back-facing image of the product.
Click the **Add Print-Area**
1. Select the appropriate back-facing Print Area based on its name, and take note of its aspect ratio.
2. Click **OK** to add this Print Area to your mockup.
Using the same steps as before, create a mockup that showcases the back of the product.
Test your product in the Personalizer.
If you’re happy with how your mockup looks, click the **Save** button to save your mockup.
After creating mockups for your product, click the **Next** button to save your work and continue.
### Step 3: Publish Your Product
You can edit settings such as the product **URL handle**, **Store currency**, and **Weight unit**:
1. `URL Handle`: A unique, user-friendly text based on your product title. It's used to create the product’s web address in your online store.
2. `Store currency`: It's pulled directly from your Shopify store settings. To change the currency, simply update it in your Shopify Admin panel. For more details, visit: [Shopify Help Center | Changing your store currency](https://help.shopify.com/en/manual/payments/shopify-payments/store-currency/changing-your-store-currency)
3. `Weight unit`: The unit of weight used for this product.
Shopify automatically formats your URL handle into a clean, SEO-friendly string containing only letters, hyphens (-), and numbers, but no spaces or special characters.
1. In the variants table, select all variants by checking the boxes.
2. Hover over the **Bulk edit** button and select **Bulk Edit Price for Variants** from the dropdown menu.
Easily update prices for all variants in bulk.
Once you've set the prices for all variants, click **Done & Publish** to list the product on your Shopify store.
Click the **Check on Shopify** to view the published product in your Shopify store.
## Preview Your Product in the Store
Click the **Customize** button on the product page of your Shopify store.
If a product is not a customizable item listed through MockSpark, the design button will not appear on its product detail page.
If everything is working properly, you should see the **Product Personalizer** interface as shown below.
You can rest assured that the **Mockspark Product Personalizer** will always appear under your store’s domain. Your customers will stay on your site and won’t be redirected to an external page.
The Product Personalizer on mobile (design)
The Product Personalizer on mobile (preview)
## Learn More
Congratulations! You've successfully created and published your first customizable product with MockSpark.
Here are some suggested next steps to enhance your customizable products:
A step-by-step guide to creating fully customizable products.
Unlock seamless customization for a unique shopping experience.
Fun images to boost your sales.
Manage your customizable product orders more efficiently.
# Picture Collections
Source: https://help.mockspark.com/docs/marketing/picture-collections
Fun images to boost your sales
## What is a Picture Collection?
A **Picture Collection** is a set of themed images that you create or carefully select to provide design options for your products. These collections are showcased in your store’s dedicated `Product Personalizer`, where your customers can use them to create their own customized designs. By offering these picture collections, you make it easier for shoppers to personalize their purchases, which can help increase customer engagement and boost sales.
Please make sure your uploaded images do not contain any copyrighted material, explicit content, or violent imagery. To keep our platform safe and respectful for everyone, we may remove content that violates these guidelines. Thank you for helping us maintain a positive experience for all users.
In general, **Picture Collections** can include your brand’s logos, promotional graphics, or themed assets for occasions like Mother’s Day, Christmas, and more.
## How It Works
1. Select **Marketing** section from the top navigation bar.
2. In the dropdown menu, click on **Pictures**.
3. After navigating to the **Picture Collections** section, click the **New Picture Collection** button on the page.
### Create Your First Collection
1. In the dialog box, enter a `title` for your new **Picture Collection**. For the **Availability status**, simply keep the default option set to `Available`.
2. Click **OK** to create it.
In the **Picture Collections** table, you’ll see a new row has been added. This is the collection you just created. Since the `Quantity` column shows that no images have been added yet, you’ll need to click **Upload** in the `Action` column to start uploading pictures to this collection.
After navigating to the details page of the picture collection, click the **Upload Pictures** button at the top of the page.
You can click or drag and drop pictures into the **Upload Pictures** area on the screen. Uploading multiple pictures at once is supported.
You can upload pictures in JPG, PNG, or WEBP formats. Each collection can include up to 60 pictures, and the size of each picture must not exceed 30 MB.
On the right side of the screen, check to make sure all your pictures have finished uploading. You can remove any that failed to upload or replace them with different ones.
Once everything has finished uploading, click the **Confirm Save** button at the bottom of the page to save your changes.
Once your changes are saved, you’ll see all the pictures you added to the collection on its details page. If you’d like to rearrange the order of these pictures, click the **Sort** button to adjust their sequence.
In the sorting dialog, drag the icon() in the top-left corner of each picture to arrange them in the order you want. When you're done, click **OK** to save your changes.
On the picture collection details page, in addition to reordering pictures, you can also view picture details or bulk remove selected pictures.
Click **Go Back** to return from the current picture collection details page to the full list of all picture collections.
In the **Picture Collections** table, you’ll see that the `Quantity` column for the collection we just worked on now shows 51 pictures. This means we’ve successfully completed creating the collection and uploading its pictures.
### Manage Collections in Bulk
After you’ve created multiple picture collections, you can click the **Sort** button to rearrange their order.
1. In the sorting dialog, drag the icon() on the left side of each picture collection to rearrange them in your preferred order.
2. Click **OK** to save your changes.
In the **Picture Collections** table, you can manage a single collection individually or select multiple collections to edit or delete them in bulk.
1. Select the collections you want to manage by checking the boxes on the left side of the table rows.
2. Click **Bulk edit** to make changes to all selected collections.
1. In the dialog box, change the **Availability status** from `Available` to `Unavailable`.
2. After clicking **OK**, the collections you selected will no longer appear in your store’s `Product Personalizer`.
After saving successfully, you’ll see that the selected collections are now marked as `Unavailable` in the **Picture Collections** table.
### Use in Product Personalizer
If everything is set up correctly, your customers can now start using the **Picture Collections** you’ve provided in your store’s `Product Personalizer`.
# Order-Items
Source: https://help.mockspark.com/docs/order-items/order-items
Manage your customizable product orders more efficiently
## What is a Order-Item?
When a customer places a customized product order through your store and completes payment, the order is automatically synced with MockSpark. Once we receive the order details, we break it down by product into smaller sub-orders, which we refer to as **Order-Items**.
**The relationship between orders and order items**: From a customer perspective, an order is a list of selected products. For example, an order might contain two cups and a hat. Each product on that list is an order item. From a store perspective, an order is a list of order items. It is part of the store's data.
Breaking down a single order into multiple **Order-Items** offers several key benefits:
1. A single order may include both customizable products fulfilled by MockSpark and other unrelated products sold in your store. Since we don’t handle those unrelated items, automatically filtering them out helps simplify order management and reduce confusion for you.
2. If a customer places one order for a T-shirt and later places another order for a hat, and both items are fulfilled through the same platform (such as Printify), we can now consolidate these Order Items based on the shipping address before sending them to the fulfillment provider. This significantly reduces shipping costs by avoiding duplicate shipment fees for items going to the same customer.
3. If an order contains an item that is out of stock or has another issue, we can easily move forward with fulfilling the available items without requiring you to manually split the order. This helps ensure faster fulfillment and reduces the risk of losing the entire order.
Go to the **Order Items** section from the top navigation bar.
## Search
The search area in the **Order Items** section supports the following six filter options:
1. `Shopify Order Name`: Unique identifier for the order that appears on the Shopify order. For example, #1000 or \_Store1001.
2. `Order Create At`: The date and time when the Order-Item was created. You can filter by a date range, with support for searching up to the most recent 90 days
3. `Product Title`: The product title with the Order-Item. Supports partial keyword search.
4. `Customer Email`: The customer's email address associated with the Order-Item.
5. `Fulfillment Platform`: The fulfillment platform responsible for processing the product in the Order-Item.
6. `Status`: The status of the Order-Item. To learn more, see our [Status of Order-Item Explained](/docs/order-items/order-items#status-of-order-item-explained)
You can apply multiple filters at once to refine your search. Click the **Search** button to view Order-Items that match your selected criteria.
## Actions for a Single Order-Item
Each row in the list represents a single Order-Item. Click on a row to view the detailed page for that specific Order-Item.
At the top of the Order-Item detail page, you can view key information about the Order-Item, including its creation date, status, and more.
In the `Store` section of the detail page, you can view various details about this Order-Item as it appears on the sales platform, such as Shopify.
On the left side of the `Store` section, you’ll find information such as **Notes**, **Customer**, and **Shipping Method** for this Order-Item.
If the customer updates details such as Notes or Customer information on the sales platform (for example, Shopify) after placing the order, you can click the **Sync** button to update the Order-Item accordingly.
You can also adjust the design of this Order-Item by clicking the **Redesign** button and making changes in the `Product Personalizer`.
In the `Product Personalizer`, you can not only edit the design of the Order-Item but also change the associated **variant**, such as the product size or style.
Click **Save Design** to save your changes.
Steps to fulfill this Order-Item:
1. Click the **Send to Fulfill** button at the top of the Order-Item detail page.
2. In the dialog box, enter the required information for fulfilling this Order-Item. The form fields may vary depending on the fulfillment platform you are using.
3. Click the **Send to Fulfill** button in the dialog box to submit this Order-Item to the assigned fulfillment platform.
Click **Move actions** to open a dropdown menu with additional available options:
1. `Export CSV`: Export the data for this Order-Item as a CSV file.
2. `Download production files`: Download the production files for this Order-Item as a ZIP file.
3. `Manually mark as fulfilled`: Manually mark this Order-Item as `Fulfilled`.
4. `Cancel order`: Manually mark this Order-Item as `Canceled`.
5. `Archive`: Manually mark this Order-Item as `Archived`.
In the `Fulfillment` section of the detail page, you can view all relevant information about this Order-Item as it appears on the fulfillment platform, such as Printify.
In the `Timeline` section of the detail page, you can view the history of actions and updates related to this Order-Item.
## Bulk Actions for Multiple Order-Items
1. On the list page, select the Order-Items you want to take action on. Each row represents a single Order-Item.
2. You can **bulk fulfill** the selected Order-Items or export them as a **CSV** file.
## Status of Order-Item Explained
1. **status:**
*This Order-Item has been placed and is currently in the queue to render the customer's design into the production files.*
2. **status:**
*The production files for this Order-Item have been successfully rendered and are now ready for fulfillment. Please review the details and confirm everything is correct before sending it to the assigned fulfillment platform.*
3. **status:**
*This Order-Item is currently being sent to the assigned fulfillment platform.*
4. **status:**
*Fulfillment has started. The product in this Order-Item is currently being picked, printed, or packaged. You can track its progress in the order view on the assigned fulfillment platform.*
5. **status:**
*This Order-Item has been printed and packaged, but it may not have shipped yet. Please check the tracking details in the order view on the assigned fulfillment platform.*
6. **status:**
*This Order-Item was paused and needs your attention. Reasons may include stock issues, design problems, or missing info.*
7. **status:**
*This Order-Item has been canceled, either by you or by the fulfillment platform.*
8. **status:**
*This Order-Item has been archived and is now hidden from the list view.*
## Order-Item Process
```mermaid theme={null}
flowchart TB
A([Customers place orders on the sales platform]) --> B[MockSpark receives Order-Item]
B --> C[Generate production file]
C --> D{Is production file generated successfully?}
D -->|Yes| E[Order-Item status: \n Ready to fulfill]
D -->|No| F[Order-Item status: \n On hold]
E --> H[Merchant checks production file and delivery info]
H --> I[Send Order-Item to fulfillment platform]
I --> J{Is Order-Item sent successfully?}
J -->|No| L[Order-Item status: \n On hold]
J -->|Yes| K[Order-Item status: \n Being fulfilled]
K --> M[Fulfillment platform completes production and shipping]
M --> N{Is there an error from the fulfillment platform?}
N -->|Yes| O[Order-Item status: \n On hold]
N -->|No| P[Order-Item status: \n Fulfilled]
P --> Q([Receive ❤ positive feedback from customers])
```
# Troubleshooting
Source: https://help.mockspark.com/docs/order-items/troubleshooting
Key considerations and common issues in order fulfillment
## Why Can't Suppliers Fulfill Orders Using Our Production Files?
Our production files are designed for products that use standard printing methods, such as Direct to Garment (DTG), All Over Printing (AOP), and sublimation printing. At this time, we do not support production methods that require specialized techniques or materials, such as embroidery, screen printing, or engraving.
Here’s a brief overview of the three printing methods we support:
#### 1. DTG Printing
Direct-to-Garment (DTG) Printing is a digital printing technology that allows images to be printed directly onto clothing or other textiles. Using equipment similar to an inkjet printer, DTG applies water-based inks directly onto the fabric, which are then cured using heat or infrared dryers to bond the ink to the material.
DTG printing offers several advantages over traditional screen printing, including:
* High-resolution, detailed, and vibrant designs with a wide range of colors
* Cost-effective for small print runs since there are no setup costs or expensive printing plates
* Faster turnaround times thanks to a fully digital production process
* Reduced waste and lower environmental impact as fewer materials and chemicals are required
Overall, DTG printing is an efficient, versatile, and eco-friendly method ideal for producing high-quality custom apparel and textile products.
#### 2. AOP
All-Over Print (AOP) is a printing technique that covers the entire surface of a fabric with vibrant, seamless, high-resolution designs. This method allows for eye-catching, full-coverage prints and is widely used in apparel, home textiles, and sportswear. In North America, all-over printing has become increasingly popular, with many producers relying on this technology to create premium, customized clothing and textile products.
Compared to Direct-to-Garment (DTG) printing, AOP has the following differences:
* Print coverage: DTG applies designs to specific areas of a garment or textile, while AOP prints cover the entire piece of fabric from edge to edge.
* Printing process: DTG uses inkjet technology to print directly onto finished garments, whereas AOP applies the design to large rolls of fabric, which are then cut and sewn into finished products.
* Production workflow: DTG is ideal for simple, on-demand, small-batch orders thanks to its straightforward process. In contrast, AOP involves more complex steps, such as printing, cutting, and sewing, making it well-suited for larger production runs and highly customized products.
In summary, DTG and AOP each have their own strengths and are best suited for different types of products and production needs. DTG is great for small runs and localized designs, while AOP is the go-to method for creating bold, all-over prints and meeting higher volume requirements.
#### 3. Sublimation Printing
Sublimation Printing is a digital printing process that transfers full-color images onto textiles or other materials using heat and pressure. The design is first printed onto a special coated paper, then transferred onto the final product using high temperature and pressure. Sublimation printing is widely used for custom apparel, home textiles, accessories, and gifts. Many manufacturers rely on this technique to create high-quality, personalized products such as t-shirts, towels, mugs, and mousepads. Sublimation printing stands out for producing vibrant colors, sharp patterns, and long-lasting results on a variety of materials, making it a popular choice for custom products with strong visual impact.
Here’s how sublimation printing differs from Direct-to-Garment (DTG) printing:
* Printing method: Sublimation uses heat and pressure to transfer ink from paper onto polyester or coated materials. In DTG printing, ink is sprayed directly onto the surface of the fabric.
* Print quality: Sublimation delivers bright, vivid colors that are durable and resistant to fading, because the ink actually becomes part of the material. DTG excels at highly detailed and realistic prints, offering greater resolution and color gradation.
* Material compatibility: Sublimation works best on polyester-based fabrics and specially coated surfaces. DTG is suitable for a wide range of natural and synthetic fibers, such as cotton, linen, silk, wool, and polyester blends.
* Production process: Sublimation requires an extra step to first print the image onto paper before it is transferred to the product, making the process more complex. DTG allows you to print designs directly onto products, which is ideal for smaller orders and quick turnaround times.
Overall, sublimation is ideal for vibrant, large-format designs and applications on specialty materials, while DTG is preferred when you need intricate, detailed graphics with a broad range of colors, especially on garments made from natural fibers.
## Why Is There a Color Difference in Print Results?
We are committed to helping merchants achieve the best possible print quality. However, due to differences between the color modes used on screens and in print production, the final printed product may not exactly match what you see on your monitor. This slight variation is a normal part of the printing process.
Monitors use the RGB color mode, while our production partners print using the CMYK color mode.
For example, monitors can display bright, vivid colors—including special and fluorescent tones—more clearly, especially in lighter shades. When an RGB design is converted to CMYK for printing, certain colors may appear more muted or less vibrant. In addition, factors like the type of paper, printing environment, and placement on the print template can introduce a color difference of about 10 to 15 percent. Some colors shown on a screen simply cannot be reproduced in print and will be replaced by the closest available alternative, which may result in the final colors looking a bit duller or less natural. Think of it like trying to mix regular watercolor paints to create fluorescent green or pink—it just isn’t possible.
To minimize noticeable color differences, we recommend avoiding colors that are difficult to reproduce accurately, such as blue-violet or brown. When designing with gray, use only black ink rather than a mix of three colors. Also, avoid using overly bright or neon colors, as they may require more ink and lead to greater color variation in the finished product.
## Why Do Designs with Transparency Look Blotchy After Printing?
Transparency as a design element can look great on certain products and with AOP, but on DTG printing, it’s tricky. If you don’t fully understand how it behaves, your final print project could look patchy or unintentional.
**DTG and transparency don’t always mix**.
Whether your semi-transparent artwork prints well on a t-shirt depends on:
* **How you created the design** – Effects like feather brushes or low-opacity layers are technically semi-transparent.
* **The level of transparency** – Fully transparent elements (100%) will disappear, but anything in between might not behave as expected.
Garment color and white underbase behavior:
* **White garments** – No white underbase, transparency will print as-is.
* **Light garments** – The underbase might peek through just a little.
* **Dark garments** – The underbase may appear as small white speckles in semi-transparent areas.
**Tip**: Always check your transparency in the Design Maker preview before ordering a test print. This will prevent surprises.
**Transparency and AOP or sublimation? No problem**
For all-over print (AOP) and sublimation products (like leggings, mugs, or towels), transparency is fine. These printing methods don’t use a white underbase, so your design will appear exactly as it looks in your final document.
Still, it’s best to fill the entire bleed area to avoid white borders or blank fabric showing through, unless you’re intentionally designing around those.
**Important note on phone cases**: Keep your design elements at either **0%** or **100% transparency**. We don’t recommend using semi-transparent areas, as they often result in **patchy or uneven printing**.
# Personalizer
Source: https://help.mockspark.com/docs/products/personalizer
Unlock seamless customization for a unique shopping experience
## Introducing Product Personalizer
Welcome to the Product Personalizer!
**Product Personalizer** is a powerful and versatile tool designed to help merchants offer a personalized customization experience for their customers. By integrating this module into your store, customers can create unique products by customizing them online according to their preferences. They can add text, images, choose colors, styles, and more to craft one-of-a-kind items.
Whether your customers are browsing on a PC or mobile device, Product Personalizer ensures a seamless and consistent user experience. It includes a variety of configurable options that adapt to different product types and industry applications.
With **Product Personalizer**, you can:
* Enhance user engagement and boost conversion rates.
* Expand the scope for personalized product designs.
* Increase customer satisfaction and brand loyalty.
This guide will walk you through how to use **Product Personalizer** and get the most out of its features.
In this tutorial, **Product Personalizer** will be referred to as **Personalizer**.
## Use on Desktop Devices
At the top right of the **Personalizer**, you can view and switch between all available product options, such as color, size, and more.
On the right side of the **Personalizer**, you can view and switch between the Print-Areas currently being customized. A product may include one or several Print-Areas, such as the front and back of a polo shirt. To learn more about Print-Areas, please visit [Products tutorial](/docs/products/products#print-areas).
On the left side of the **Personalizer**, you’ll find the tools for adding design elements to the canvas.
There are several ways to add design elements. First is the **Pictures** section, which offers a collection of images provided by the merchant. To learn more about the `Pictures` feature, please visit [Picture Collections tutorial](/docs/marketing/picture-collections).
1. Select **Pictures** as your method for adding design element.
2. In the **Pictures** panel that appears to the right of the button, choose your preferred image and add it to the canvas to begin designing.
The second way to add design elements is by using the **Visuals** section, where you can place a variety of fun vector graphics (such as stickers, emojis, and more) onto your design canvas.
**Visuals** are design assets provided by the MockSpark platform. These assets are typically vector images, which means they can be scaled without losing quality. This makes them ideal for different printing needs and helps prevent issues like blurry or low-quality prints.
Because of how Visuals work, each Print-Area can contain up to three Visuals at a time.
1. Select **Visuals** as your method for adding design element.
2. In the **Visuals** panel that appears to the right of the button, browse and select your preferred visual to add it to the canvas.
In addition to the two methods mentioned earlier, you can also add text to your design canvas through the **Text** feature. We offer a variety of fonts for you to choose from.
1. Select **Text** as your method for adding design element.
2. In the **Text** panel that appears to the right of the button, choose your preferred font and add it to the canvas to begin designing.
If the previous methods for adding design elements don't suit your needs, you can use the **Uploads** feature to add your own images to the design canvas. This could be photos you've taken yourself or images generated by other AI tools.
We support images in JPG, PNG, and WebP formats.
1. Select **Uploads** as your method for adding design element.
2. In the **Uploads** panel that appears to the right of the button, you can upload images by taking or selecting them from your current device. You can also upload images by scanning a QR code with your phone.
At the center of the **Personalizer** is our design area, also known as the `canvas`. When you select a `text design element` on the canvas, a control bar for that text automatically appears above it. This control bar allows you to customize various properties of the text, such as color, font, and size.
Double-clicking the text on the canvas lets you edit its content.
When you select an `image design element` on the canvas (excluding Visuals), a control bar automatically appears above it. This bar allows you to crop, flip, rotate, and perform other edits on the image.
Below the canvas, you'll see an estimate of the image's print quality. If you receive a **Low resolution** warning during the design process, it means you need to adjust your design to ensure better print quality.
When you select a `visual design element` on the canvas, such as a sticker or emoji, a control bar automatically appears above it. This bar allows you to flip, rotate, and make other adjustments to the visual.
Visual design elements do not show print quality warnings like image elements might.
When you right-click on a design element, you can duplicate or delete it. You also have the option to adjust its layer order within the current design or align it on the canvas.
In addition to manipulating individual design elements on the canvas, you can use the canvas control bar below the **Personalizer** to manage the entire canvas of the current Print-Area.
1. Select **Layer** from the canvas control bar at the bottom of the **Personalizer**.
2. In the **Layer** panel that appears, you can view, remove, and manually rearrange the order of the design elements by dragging them.
Steps to change the background color of the current canvas:
1. Select **Background** from the canvas control bar at the bottom of the **Personalizer**.
2. In the **Background** panel that appears, choose the color you want to apply.
If you want to **Undo** or **Redo** your actions, the canvas control bar at the bottom of the **Personalizer** offers these functions.
At the bottom left of the **Personalizer** is the preview window that displays the current design effect. When you move your mouse over this window, buttons for switching between preview images will appear.
The design preview images in the Personalizer are essentially product mockups created by the merchant. If the merchant has made only one mockup for this particular product specification, there will be just one preview image available here.
Once you've finished your design, click the **Add to cart** button at the top right corner of the **Personalizer**. A dialog box will appear, allowing you to enter the `quantity` of the customized product you wish to purchase.
Additionally, if there are any issues such as `undesigned` Print-Areas or images with `poor print quality`, the dialog box will alert you. It's recommended that you make adjustments to your design based on these alerts to ensure better print results.
## Use on Mobile Devices
`Personalizer` is available for use on both desktop and mobile devices.
When you access `Personalizer` on a mobile device, you'll find a button in the center of the interface. Tap this button to add design elements to your canvas.
In the interface, tap **Add Sticker** to add `visual design elements` to your canvas.
Select a `sticker` that you like, then tap it to add it to your canvas.
Once you've added the `sticker` to your canvas, you'll see it highlighted as the selected item.
Additionally, a control panel will appear at the bottom of the canvas, allowing you to perform various actions on the `sticker`.
Tap the button in the center of the interface, then select **Add Image** to either add `picture design elements` to your canvas or `upload` your own image.
Add images provided by the vendor, known as **Pictures**. To learn more about the `Pictures` feature, please visit [Picture Collections tutorial](/docs/marketing/picture-collections).
Tap **Pictures** in the interface.
1. Choose a `picture collection` that you prefer.
2. Select a `picture` you like, then tap it to add it to your canvas.
Once you’ve added the `picture` to your canvas, you’ll see it highlighted as the selected item.
Additionally, a control panel will appear at the bottom of the canvas, allowing you to perform various actions on the `picture`.
Above the canvas, you'll see an estimate of the image's print quality. If you receive a **Low resolution** warning during the design process, it means you need to adjust your design to ensure better print quality.
In addition to using vendor-provided **Pictures**, you can also **Upload** images from the photo gallery on your mobile device.
We support images in JPG, PNG, and WebP formats.
Tap **Uploads** in the interface.
Once you upload an `image` to your canvas, you’ll see it highlighted as the selected item.
Additionally, a control panel will appear at the bottom of the canvas, allowing you to perform various actions on the `image`.
Above the canvas, you'll see an estimate of the image's print quality. If you receive a **Low resolution** warning during the design process, it means you need to adjust your design to ensure better print quality.
Tap the button in the center of the interface, then select **Add Text** to include text on your canvas.
1. Enter the `text` you want to display in the multiline text box.
2. Tap **DONE** to add the text to your canvas.
Please refrain from using emoji in your text, as this may lead to printing inconsistencies in actual production.
Once you’ve added the `text` to your canvas, you’ll see it highlighted as the selected item.
Additionally, a control panel will appear at the bottom of the canvas, allowing you to perform various actions on the `text`.
At the bottom of **Personalizer**, you can view and switch between the Print-Areas currently being customized. A product may include one or several Print-Areas, such as the front and back of a polo shirt. To learn more about Print-Areas, please visit [Products tutorial](/docs/products/products#print-areas).
1. After finishing the design for the current `Print-Area`, you can switch to other Print-Area of the product to continue designing.
2. Once your design is complete, tap the **Preview** button located on the right side of the top bar in **Personalizer** to preview the final look of your design.
In the `Preview` interface, you can not only see your design but also view and switch between all available product `options`, such as color and size.
Once everything is confirmed and looks good, tap the **Add to Cart** button at the bottom of the `Preview` interface to proceed.
After tapping the **Add to Cart** button, a dialog box will appear where you can enter the `quantity` of the customized product you wish to purchase.
Additionally, if there are any issues such as `undesigned` Print-Areas or images with `poor print quality`, the dialog box will alert you. It's recommended that you make adjustments to your design based on these alerts to ensure better print results.
# Products
Source: https://help.mockspark.com/docs/products/products
A step-by-step guide to creating fully customizable products
## Types of Customizable Products
In MockSpark, there are two main types of products: **Third-Party Fulfilled Products** and **Seller-Fulfilled Products**.
Third-Party Fulfilled Products are items that are fulfilled through external platforms directly integrated with Mockspark. This includes services like Printify, Printful, and other supported fulfillment providers.
Seller-Fulfilled Products include items that the seller handles independently. This means the seller is responsible for providing product information, managing production, and shipping orders. It also includes products fulfilled through third party services that are not currently connected to Mockspark.
Importing a **Third-Party Fulfilled Product** into MockSpark is simple and straightforward. The fulfillment provider supplies all the necessary product information, so all you need to do is create your mockups. Once they’re ready, you can start selling the customizable product in your store right away.
To learn how to import a Third-Party Fulfilled Product, check out our [Quick Start Guide](/docs/get-started/quickstart).
If you want to sell a unique customizable product that you produce yourself, or if you're using a print-on-demand and dropshipping platform that isn't currently supported by our list of third-party fulfillment providers, you can manually create a **Seller-Fulfilled Product**.
# Create a Seller-Fulfilled Product
In this tutorial, we’ll walk you through the step-by-step process of creating a **POLO SHIRT** that comes in six colors (`White`, `Grey`, `Black`, `Red`, `Stone`, and `Navy`) and three sizes (`S`, `M`, and `L`). Using this product as an example, you’ll learn helpful tips and best practices for creating **Seller-Fulfilled Products**.
We’ve prepared image assets for the sample product (**POLO SHIRT**) to help you get started. [**Click here**](https://cdn.mockspark.com/assets/docs/Polo_Shirt_Image_Assets.zip) to download the **zip file** to your desktop and extract its contents.
## Step 1: Edit Basic Details
1. Go to the **Products** section from the top navigation bar.
2. Click the **Create Seller-Fulfilled Product** button.
### Basic Information
1. Please enter your product title.
2. Please enter a detailed description of your product in the rich text editor.
Click **New Image** to upload a picture for your product.
Choose how you'd like to upload your product image.
Upload a front view of a `White` polo shirt, then click **Using this image**.
### Brand
Enter the vendor name for this product.
### Print-Areas
Select **Add Print-Area**.
Name this Print-Area `Front Side`.
A **Diagram** is a sample image shown in the Print-Areas panel of the `Product Personalizer`. It's designed to help customers easily identify and differentiate between various Print-Areas on a product.
Uploading a **Diagram** is optional. If you don’t provide one, the system will automatically generate a default image based on the size of each Print-Area.
**Diagrams** image must be in .jpg or .png format, sized at 100 × 100 pixels, and no larger than 1 MB.
Upload an image to use as the **Diagram** for this Print-Area.
A **Mask** is an optional overlay image that appears above the Print-Area canvas in the `Product Personalizer`. It serves as a visual guide to help customers better understand the boundaries of the designable area when creating their designs.
While useful, uploading a **Mask** is not required and won’t impact the core design functionality of the `Product Personalizer`.
**Mask** image must be in .png format, sized at 600 × 600 pixels, and no larger than 1 MB.
Upload an image to use as the **Mask** for this Print-Area.
MockSpark automatically transforms the designs your customers create in the `Product Personalizer` into print-ready image files optimized for factory production. These files are referred to as **Placeholders** within the MockSpark platform.
Setting the **output format** for a Print Area determines the file format of the **Placeholder**.
Currently, MockSpark supports five formats, including:
* `PNG`
* `TIFF`
* `TIFF_CMYK`
* `JPEG`
* `JPEG_CMYK`
In this tutorial, we'll set the Print Area's **output format** to `TIFF_CMYK`.
A single Print-Area can have multiple values assigned to it, typically to represent different print sizes.
For example, if your polo shirt is available in three sizes (`S`, `M`, and `L`), you can provide the appropriate print dimensions for each one based on their actual measurements, like this:
| Width (px) | Height (px) | DPI |
| ---------- | ----------- | --- |
| 3623 | 4276 | 300 |
| 3713 | 4382 | 300 |
| 3893 | 4595 | 300 |
**What is DPI**
In the printing industry, **DPI** (Dots Per Inch) refers to the number of ink dots a printer can produce within one inch.
We offer three DPI settings: `150`, `300`, and `600`. The default is set to 300 DPI. The DPI you choose should depend on the specifications of your production printer. If you're unsure which DPI to select, we recommend going with the default `300` DPI, as it is the most commonly used option and generally works well for most printing needs.
**How to Determine Print Size Using DPI**
To calculate the print size in pixels based on DPI, let’s use an example.
Say Product A has a printable area of `12` inches by `14` inches, and your printer is set to `300` DPI. The pixel size would be:
* `Width`: 12 × 300 = 3600 px
* `Height`: 14 × 300 = 4200 px
Inches × DPI = Pixels
If you're using the metric system, you can convert units using the following:
1 inch = 2.54 cm
1. Click **Add another value** to create 3 value rows.
2. For each value row, enter the appropriate settings for `Width`, `Height`, and `DPI`.
3. Click **OK** to complete the creation of this Print-Area.
We've just created our first Print-Area, named `Front side`. Next, we'll set up another Print-Area for the back of the product.
Select **Add Print Area**.
Following the same steps as the previous Print-Area, let's create a new one for the back of the polo shirt and name it `Back Side`.
Select the appropriate images to use as the **Diagram** and **Mask** for this Print-Area.
Enter the values for this Print-Area based on the list below.
| Width (px) | Height (px) | DPI |
| ---------- | ----------- | --- |
| 3650 | 4432 | 300 |
| 3737 | 4538 | 300 |
| 3913 | 4751 | 300 |
1. Create a Print-Area named `Back side`.
2. Click **OK** to complete the creation of this Print-Area.
Once you've created these Print-Areas, you can still edit, delete, or reorder them as needed.
### Variant Options
Now that we've finished setting up the Print-Areas for this product, let's move on to creating its **Variant options**.
Each product can have up to three variant options. Combinations of these options define all the possible variations of the product.
In this tutorial, we will create two options for variants: one for `Color` and one for `Size`.
Click **Add Another Option**
Name this variant option `Color`.
1. Click **Add another value** to create 6 value rows.
2. Enter a different color for each value row: `White`, `Grey`, `Black`, `Red`, `Stone`, and `Navy`.
3. Click **OK** to complete the creation of this variant option.
After setting up the `Color` variant option, let’s move on to creating the `Size` variant option.
Click **Add Another Option**
1. Create a variant option named `Size`, and add 3 value rows to it: `S`, `M`, and `L`.
2. Click **OK** to complete the creation of this variant option.
Once you've created these variant option, you can still edit, delete, or reorder them as needed.
### Variants
Once you've created the two variant options, such as `Color` and `Size`, the system will automatically generate a variant table that combines these options for your product.
In the **Variants** table, you can view all the different versions of your product.
1. In the **Variants** table, we’ve selected all product variants in size `S`.
2. Click on **Bulk Edit**.
Select **Bulk Edit Print Areas for Variants**.
1. For the **Print Area (Front side)** field, select `3623 × 4276 px`.
2. For the **Print Area (Back side)** field, select `3650 × 4432 px`.
3. Click **Apply to Selected Variants**.
In the table, you’ll see that the Print Area values for the size `S` variant have been applied in bulk.
In the same way:
1. In the **Variants** table, check all the variants that are size `M`.
2. Click **Bulk Edit** and select **Bulk Edit Print Areas for Variants**.
1. For the **Print Area (Front side)** field, select `3713 * 4382 px`.
2. For the **Print Area (Back side)** field, select `3737 * 4538 px`.
3. Click **Apply to Selected Variants**.
In the same way:
1. In the **Variants** table, check all the variants that are size `L`.
2. Click **Bulk Edit** and select **Bulk Edit Print Areas for Variants**.
1. For the **Print Area (Front side)** field, select `3893 * 4595 px`.
2. For the **Print Area (Back side)** field, select `3913 * 4751 px`.
3. Click **Apply to Selected Variants**.
At this point, all data in the `Print Areas` column of the **Variants** table has been fully set up.
1. In the **Variants** table, select all variants with the color set to `White`.
2. Click **Bulk Edit**.
select **Bulk Set Image for Variants**.
Choose a method to upload images for the `White` variants.
Since these variants are `White`, we'll use an image that shows the front view of the product in `White`.
Once the upload is complete, click **Using this image**.
In the **Variants** table, you can see that the images for all variants with the color `White` have been successfully set.
Using the same process, upload images for the remaining variants in `Grey`, `Black`, `Red`, `Stone`, and `Navy`.
In addition to bulk editing multiple variants, you can also edit individual variants directly within the table.
1. For example, you can update information like the `SKU` or `Fulfillment SKU` for a specific variant
2. Click **OK** to save your changes.
Click **Next** to save all changes made to the product's basic information in Step 1. If you don't, any edits made on this page will not be saved.
## Step 2: Create Mockups
On the Step 2 screen, you’ll see a **Mockup Group** that includes all product variants. This is a system-generated group named `default`.
### New Mockup: Front Side
Click **New Mockup** to open the Mockup Creator and build a mockup for your product.
### Product Image
To create a mockup, begin by clicking the button shown in the image below to upload a product photo.
Select or upload a `front-facing` image of the `White` product to create your first **Mockup**.
Click the **Using this image** button.
You can zoom in or out of the workspace by using the slider in the bottom bar of the `Mockup Creator` or by scrolling with your mouse wheel.
**Mockup Creator** is the tool provided by MockSpark that allows merchants to create product mockups online.
### Print-Areas
Click on the **Print Areas** section in the right-hand panel.
Click the **Add Print-Area**.
1. Select the appropriate front-facing Print Area based on its name, and make note of its aspect ratio.
In Step 1, we created two Print-Areas: `Front side` and `Back side`. Here, we'll be using the `Front side`.
2. Click **OK** to add this Print Area to your mockup
Drag each of the 4 corners of the Print Area to the appropriate position on the product image.
In the Print Areas section of the right-hand panel, change **Mesh Warp** from **2D** to **3D**.
In **3D Mesh Warp** mode, the Print Area’s 4 corner points will be replaced with a 4x4 grid, giving you 16 adjustable control points.
Using the Print Area’s aspect ratio as a guide, adjust the control points to reshape the Print Area. This helps create a more realistic and natural-looking product mockup.
If your product is `White`, we recommend changing the **Blending Mode** from **Normal** to **Multiply** in the Print Areas section on the right-hand panel. This will help enhance the mockup’s visual appearance for a more realistic effect.
For the best results, we recommend setting the Print-Area's `Blending Mode` to `Multiply` only on **light-colored products**.
The `Multiply blend mode` creates darker colors by multiplying the base color with the blend color. In this mode, white areas in the blend layer become completely transparent and don’t affect the layers beneath, while black areas remain fully visible. It always darkens the image and never makes it lighter.
### Overlay
Click on the **Overlay** section in the right-hand panel.
Click **Add Image**
The **Overlay image** in a mockup is an image layered over the product photo. It is typically used in the following scenarios:
1. If your mockup shows a person holding a mug and part of the mug’s Print Area is covered by the hand, you can upload an **Overlay image** to create that realistic overlapping effect.
2. If your mockup features a canvas tote bag with natural shadows or texture details, you can use an **Overlay image** to recreate those lighting or fabric effects as a filter.
Uploading an **Overlay image** is optional and depends entirely on your needs.
In this tutorial, since we’re creating a mockup for a polo shirt, we’ll upload an **Overlay image** that includes the shirt’s collar and sleeves.
Click **Using this image**.
Once the **Overlay image** has been added, you’ll see it appear above the Print-Areas in the mockup.
### Brush
Click on the **Brush** section in the right-hand panel.
In the **Brush** panel:
1. Set the **Brush Type** to **Erase**
2. Adjust the **Brush Size** as needed
3. Move your mouse over to the canvas on the left and use the brush to erase any parts of the print area that you don’t want shown in the mockup.
The brush tool is limited to the Print-Area.
While creating your mockup, you can use the **Undo** and **Redo** options in the top toolbar of the `Mockup Creator` to easily reverse or repeat any actions.
To zoom in or out of the workspace for more precise editing, use the slider in the bottom toolbar or scroll with your mouse wheel.
With these tools and adjustments, you’ll be able to create a polished mockup that perfectly showcases the front of your product.
Click the **Preview** button to open the Personalizer and preview the current mockup.
Test your product in the `Product Personalizer`:
1. In the Print Areas panel on the right, select the print area labeled `Front side` to start designing.
2. Use the Elements panel on the left to add a design element (such as an image or text) to the canvas.
3. Adjust your design on the canvas and review the product preview in the bottom-left corner to see if it looks the way you want.
4. Click **Back** to return to the Mockup Creator.
If you’re happy with how your mockup looks, click the **Save** button to save your mockup.
### New Mockup: Back Side
We’ve already created a Print Area for the front of the product, now let’s set one up for the back.
Select or upload a back-facing image of the product.
Click the **Using this image** button.
Click on the **Print Areas** section in the right-hand panel.
Click the **Add Print-Area**.
1. Select the appropriate back-facing Print Area based on its name, and make note of its aspect ratio.
In Step 1, we created two Print-Areas: `Front side` and `Back side`. Here, we'll be using the `Back side`.
2. Click **OK** to add this Print Area to your mockup
Using the same steps as before, create a mockup that showcases the back of the product.
Click on the **Overlay** section in the right-hand panel.
Click **Add Image**
In this tutorial, we're creating a model for a polo shirt. We'll upload an **Overlay image** that includes the shirt's collar and sleeves, and is also suitable for the back of the product.
Click **Using this image**.
Click on the **Brush** section in the right-hand panel.
In the **Brush** panel:
1. Set the **Brush Type** to **Erase**
2. Adjust the **Brush Size** as needed
3. Move your mouse over to the canvas on the left and use the brush to erase any parts of the print area that you don’t want shown in the mockup.
The brush tool is limited to the Print-Area.
Click the **Preview** button to open the Personalizer and preview the current mockup.
Test your product in the Personalizer.
If you’re happy with how your mockup looks, click the **Save** button to save your mockup.
### New Mockup Group
So far, we've created two mockups within the `default` **Mockup Group**: one showing the `front` of the product in white, and another showing the `back`. However, our product comes in more than just `White`. Next, we'll create separate **Mockup Groups** for each available color variant.
Select **New Mockup Group** to create a group for organizing the mockups of the `Grey` color variant.
In the form dialog titled **Create Mockup Group**, follow these steps:
1. In the `Mockup Group Title` field, enter `Grey` as the group name.
2. Under `Matching Variants` field, select all variants that are in the `Grey` color.
3. Click the **>** button in the center of the dialog to move the selected variants from the `Source Box` to the `Target Box`. This assigns them to the new `Grey` Mockup Group.
4. Click **OK** to save your changes.
After successfully saving, you’ll see the new **Mockup Group** appear in the interface, containing all variants in the `Grey` color.
While you can click **New Mockup** to create a new mockup from scratch for the `Grey` **Mockup Group**, there's a faster way. Since we’ve already created a front-facing mockup for the `White` product earlier, you can simply reuse that one to save time.
Click **Duplicate** on the `front` mockup of the `White` product within the `default` **Mockup Group**.
1. In the dialog that appears, select `Grey` as the target **Mockup Group**.
2. Click **OK** to complete the duplication.
You'll see in the interface that the `Grey` **Mockup Group** now includes a duplicate front mockup displaying the `White` product.
Click the **Edit** button on the duplicated mockup. We'll update it to display the `front` view of the `Grey` product instead of the `White` one.
In the right-hand panel of the `Mockup Creator`, select **Product Image** and click **Edit**.
Click **Select another image**.
Replace the original front image of the `White` product with the front image of the `Grey` product.
Click **Using this image**.
In the right-hand panel of the `Mockup Creator`, select **Print Areas**.
Since the product is now `Grey` and not part of the `light color` range, using the `Multiply blend mode` is not appropriate in this case.
1. Change the **Blending Mode** from **Multiply** back to **Normal**.
2. Click the **Preview** button to open the `Product Personalizer` and preview the current mockup.
Once you've confirmed that the preview in the `Product Personalizer` has been updated to show the `Grey` product, click **Back** to return to the `Mockup Creator`.
If you’re happy with how your mockup looks, click the **Save** button to save your mockup.
After finishing the `front` mockup for the `Grey` product, use the same method to create a `back` mockup.
Click **Duplicate** on the `back` mockup of the `White` product within the `default` **Mockup Group**.
Click the **Edit** button on the duplicated mockup. We'll update it to display the `back` view of the `Grey` product instead of the `White` one.
Also, change the **Blending Mode** from **Multiply** back to **Normal**, then click the **Save** button to save your mockup.
At this point, we’ve successfully created a **Mockup Group** for all `Grey` variants that includes both `front` and `back` product mockups.
Using the same approach, you can create a **Mockup Group** that includes all `Black` variants.
Using the same approach, you can create a **Mockup Group** that includes all `Red` variants.
Using the same approach, you can create a **Mockup Group** that includes all `Stone` variants.
Using the same approach, you can create a **Mockup Group** that includes all `Navy` variants.
In the end, only the `White` variants remain under the **Matching Variants** section of the **Mockup Group** named `default`.
Aside from the `default` Mockup Group, you can `modify` the variants included in any other Mockup Group or `delete` the group entirely.
Click **Next** to save all the mockups you created in Step 2. Otherwise, any changes made on this page will not be saved.
## Step 3: Publish Your Product
### URL / Currency / Weight
You can edit settings such as the product **URL handle**, **Store currency**, and **Weight unit**:
1. `URL Handle`: A unique, user-friendly text based on your product title. It's used to create the product’s web address in your online store.
Shopify automatically formats your URL handle into a clean, SEO-friendly string containing only letters, hyphens (-), and numbers, but no spaces or special characters.
2. `Store currency`: It's pulled directly from your Shopify store settings. To change the currency, simply update it in your Shopify Admin panel. For more details, visit: [Shopify Help Center | Changing your store currency](https://help.shopify.com/en/manual/payments/shopify-payments/store-currency/changing-your-store-currency)
3. `Weight unit`: The unit of weight used for this product.
### Variants
1. In the **Variants** table, check the boxes next to the variants you want to work with.
2. Click on **Bulk edit**, then choose from the available options to update properties like `Price`, `Weight`, and `Availability` for the selected variants.
After completing the bulk actions, you’ll see the updated values reflected in the **Variants** table.
In addition to bulk editing multiple variants, you can also edit individual variants directly within the table.
1. On the right side of the `row` for the variant you want to edit, click **Edit**.
2. Update the information for that variant as needed.
3. Click **OK** to save your changes.
You’ll see that the variant has been updated in the **Variants** table.
After confirming that all product information in Step 3 meet your requirements, click **Done & Publish** to list the product on your Shopify store.
Click the **Check on Shopify** to view the published product in your Shopify store.
## Preview Your Product in the Store
Click the **Customize** button on the product page of your Shopify store.
If everything is working properly, you should see the `Product Personalizer` interface as shown below.
The Product Personalizer on mobile (design)
The Product Personalizer on mobile (preview)
# Mockup Examples
Source: https://help.mockspark.com/docs/products/tutorials
Explore a variety of modeling case studies with our tutorial videos and improve your mockup creation skills.
## Modeling Example 1
Quickly create a mockup with an **overlay** image.
## Modeling Example 2
Use **3D mesh warp** to design a curved mockup.
## Modeling Example 3
Make your mockup more realistic with **multiply blend mode**.
# Team Management
Source: https://help.mockspark.com/docs/team/team-management
Easily customize role permissions to keep your team organized and working smoothly
## Introducing Team Management
Our Team Management feature is designed to help you organize your teams more efficiently and collaborate with ease. With this tool, you can define custom roles, assign the right permissions, and add team members with specific responsibilities, creating a permission structure that fits your organization’s needs.
This feature allows you to:
* Clearly define roles and responsibilities to boost collaboration.
* Control access levels to protect sensitive information.
* Monitor and adjust your team structure as your business grows.
In the following steps, we’ll walk you through how to create roles, add team members, and make the most of Team Management to streamline your daily operations.
## Create a New Role
1. Select **Team** section from the top navigation bar.
2. In the dropdown menu, click on **Roles**.
The **Store owner** refers to the Shopify admin account for a given store. Our system automatically creates a role called `Owner` for this account. This role has full permissions by default and cannot be edited or deleted.
Click **New Role** button to create a new role.
1. Enter a name for the new role in the **Role name** field.
2. Select the **Permissions** you want to assign by checking boxes within the six permission sets.
Each permission set includes two access levels: `View` and `Manage`. The `View` permission allows users to see the data, while the `Manage` permission grants the ability to edit it.
* The **Account** permission set includes the most essential permissions for any role. In most cases, this should be selected for all roles; without it, users may not be able to perform basic account-related actions.
* The **Connections** permission set determines whether a user can view and manage features within the `Connections Section`.
* The **Products** permission set controls whether a user can access and manage features within the `Products Section`, such as creating new products and publishing them to your store.
* The **Order Items** permission set determines whether a user can view and manage features within the `Order Items Section`, such as reviewing and fulfilling order items.
* The **Billing** permission set controls whether a user can access and manage features within the `Billing Section`, such as viewing usage and purchase data, upgrading the subscription plan.
* The **Marketing** permission set determines whether a user can view and manage features within the `Marketing Section`, such as accessing and editing resource collections like pictures and other media.
3. Click **Save** to create the role.
## Invite a Team Members
Once you’ve confirmed that the new role has been successfully created, you can move on to adding a team member.
1. Select **Team** section from the top navigation bar.
2. In the dropdown menu, click on **Staff**.
Click **New Staff** button to create a new team member.
1. In the dialog box, enter the new member’s `name`, `email address`, and assigned `role`.
2. Click **Save** to add the new team member.
In the **Staff** table, you’ll see the newly added team member listed. At the same time, the system will automatically send an invitation `email` to that staff.
Once the invited team member clicks **Accept Invitation** in the `email`, they will be redirected to the MockSpark account activation page.
The email may take a few minutes to arrive, so please be patient. If you haven’t received it after 15 minutes, check your spam or junk folder. You can also resend the invitation if needed.
1. On the account activation page, the invited team member can set their **Account Password**, which will be used for future logins. The password must meet the requirements shown on the left side of the screen.
2. Click **Submit** to complete the account activation process.
After the team member successfully activates their account, they will be redirected to the login page. On that page, look for the text that says `"You are a staff? Login here"` and click it to switch to the **Staff Login** view.
1. On the **Staff Login** page, team members who have completed account activation need to enter their `email address` and `password`.
2. Click **Login** to access MockSpark.
## How Can Staff Reset Their Password?
If a team member wants to change their password, they can follow these steps:
This feature is exclusively for team staff members. Store owners should use Shopify OAuth for login.
1. After logging in to MockSpark, click the profile icon in the top-right corner of the page.
2. Select **Reset Password** from the dropdown menu.
1. On the reset password page, team members can set a new password for their account. The password must meet the requirements listed on the left side of the screen.
2. Click **Submit** to confirm and update the password.
If a team member forgets their password and is unable to log in, they can reset it by following these steps:
On the login page, switch to the staff login view and click **Forgot Password**.
1. On the reset password page, team members need to enter the `Shopify domain` of their store along with the `email address` associated with their account. A password reset confirmation link will be sent to that `email`.
2. Click **Submit** to send your request.
If everything is correct, the team member will receive an email with a link to reset their password. By clicking the **Reset Password** button in the email, they will be taken to a page where they can complete the password reset process.
The email may take a few minutes to arrive, so please be patient. If you haven’t received it after 15 minutes, check your spam or junk folder. You can also resubmit your request at any time if needed.