User manual

How to use Mitasu for Home. Pick a category on the left and open any item to see step-by-step instructions with screenshots.

Getting started

You can start right after installing. First, learn the plans, then place the block on your product page once.

What happens when you install

On install, the app automatically prepares where your product information is stored. The very first time you open it you'll see a preparation screen with a progress bar — it takes under a minute, so leave the screen open until it finishes.

  1. When it's done, the Dashboard appears.
  2. Follow the setup-guide steps.
  3. You can load samples to see how everything behaves right away.
Screenshot coming soon — HOME-SHOT-01 First-run setup
Plans and free trial

The basics — dimension sheets, materials & finish, assembly & delivery, and Q&A — are free forever. Room scenes, sets, owner feedback and the owner verdict, plus bulk assignment, CSV import and returns analysis, are Pro ($12.99/month or $129.99/year).

From day one you get a 30-day free Pro trial. When it ends the app reverts to Free automatically, with no surprise charge.

Switching plans happens on the Pricing page only. The plan summary you see on the Dashboard and in Settings tells you the current contract; changing it always takes you to that page.

Screenshot coming soon — HOME-SHOT-02 Pricing
Place the block on your product page

In the theme editor, add the app block "Dimensions and product details" to your product page once. From then on, whatever you assign appears automatically — no per-visit setup.

  1. Open Online Store → Themes → Customize.
  2. Select the product page template.
  3. Add block → "Dimensions and product details", position it, and save.

In the block's settings you choose whether it sits inline on the page or opens as a popup from a button, and whether the sections switch with tabs or stack vertically. Colors follow your store's brand. Any section with no content is hidden automatically.

Screenshot coming soon — HOME-SHOT-03 Theme editor
Set which sections show, and in what order

Settings → "Sections to show & order" lets you drag to reorder the sections on the product page, toggle each one on or off, and rename its heading.

The same screen is where you pick the doorway width the doorway-fit check assumes (70 / 76 / 80 / 90 cm) and the day the week starts on for return imports and trend charts.

The same screen has a Re-check control. If a product page ever looks off, run that first: it verifies the app's status and repairs anything that's missing.

Screenshot coming soon — HOME-SHOT-04 Sections to show & order

Reading the dashboard

The first screen you land on. It is built to answer two things only: what is missing, and what to do next.

Coverage, the setup guide, and what needs attention

The figures at the top are information coverage: for each feature, how many of your products already carry it. You do not need to reach 100 % — a feature you switch off in Settings drops out of the calculation entirely.

The setup guide is three steps (choose your features, create a template, assign it to products) and ticks itself from real state rather than from a checklist you clicked. It shows only while a step is still outstanding.

Needs attention (Pro) counts the products whose owner votes lean one way — firmer than expected, darker than the photos. Treat it as a shortlist of descriptions and photos worth revisiting.

Screenshot coming soon — HOME-SHOT-23 Dashboard

Dimension sheets

The core feature: build a dimension sheet, then show the dimension figure, the packaged sizes, and the doorway-fit check — "will it get into my home?" — on the product page.

Create a dimension sheet (category and rows) Free

A dimension sheet is a reusable template built around a furniture category. There are 13 categories — sofa, table, desk, chair, bed, mattress, bedding, pillow, shelf, rug, curtain, lighting and kitchen — and each one shows only the measurement columns that make sense for it (width, depth, height, seat height and so on). You can also start from one of 45 ready-made templates (kitchen has no bundled template — it uses the table alone).

  1. Open Dimension sheets and create a new one.
  2. Pick the category, or the closest ready-made template.
  3. Add one row per variation, fill in the numbers, and save. “Load standard dimensions” pre-fills typical figures for the category as a starting point.
  4. Then assign the sheet to products from the product edit page.

If a product's title or description already contains W×D×H, the app can read those numbers and suggest the category to pre-fill a draft. That's plain text parsing, not AI.

Screenshot coming soon — HOME-SHOT-05 Create a dimension sheet
The dimension figure comes with the category Free

Choosing a category also gives you the dimension figure shown on the product page: an illustration of that kind of furniture with width, height and depth arrows drawn over it. You never have to draw your own.

The A, B and C letters on the drawing match the column headings of the table, so shoppers can tell at a glance which number is which. If you already have a product photo with the measurements drawn on it, set it on the sheet and it replaces the drawing.

Screenshot coming soon — HOME-SHOT-06 Dimension figure on the storefront
Packaged sizes and the doorway-fit check Free

A dimension sheet can also carry the packaged sizes — width, depth and height of each box that arrives. Fill those in and the product page grows a "Delivery boxes & getting it in" section where a shopper can enter their own doorway width and run the doorway-fit check.

The verdict is a simple comparison: the box's smallest side plus 2 cm of clearance is the width it has to pass through, checked against the openings the shopper measured. Beyond the door itself, the app asks about hallway corners, elevators, stairs and loading into a car — but only for the legs of the route the shopper picks.

The whole calculation runs inside the shopper's browser; nothing they type is sent anywhere. The screen also says plainly that the result is a guide figure.

If even the largest box clears the doorway width chosen in Settings (70 cm by default; 76, 80 or 90 cm selectable), no questions appear — just one line saying it fits through a normal door. And a product with no packaged sizes doesn't show this at all.

Screenshot coming soon — HOME-SHOT-07 Doorway-fit check
About units (entry unit from Settings, automatic on the storefront) Free

The unit you type values in follows Settings → Default unit. It's chosen automatically from the store's country (inch for US stores, cm elsewhere by default) and you can change it any time. Whichever you pick, values are always stored internally in cm, so switching later never corrupts your data.

On the product page the unit follows the shopper's own country instead (inch in the US and Canada, cm elsewhere), and shoppers can toggle it themselves. Your entry unit never changes what they see.

Screenshot coming soon — HOME-SHOT-08 Settings: default unit

Materials & finish

What each part is made of and how it feels. Choose a material and a finish per part, and add firmness, weight capacity, care and certifications — all in one reusable template. Free.

Build a materials & finish template Free

Materials & finish is a template you assign to products and reuse. Fix it once and every product using it updates.

  • Material and finish per part: 10 parts (legs, top, upholstery and so on) combined with 26 materials and 10 finishes.
  • Firmness: a 1 (soft) to 5 (firm) scale.
  • Weight capacity: in kg.
  • Care: pick from 16 furniture-specific instructions (how to wipe, oiling, direct sunlight, felt pads…), shown with matching icons.
  • Certifications: 11 of them, including FSC, GREENGUARD and OEKO-TEX.

Material names are stored in canonical English and translated at display time, so a template you fill in in Japanese still reads correctly for an English-speaking shopper.

  1. Open Materials & finish and add a template.
  2. Fill in parts, materials, finishes, firmness, weight capacity, care and certifications.
  3. Save, then assign it to products from the product edit page.
Screenshot coming soon — HOME-SHOT-09 Materials & finish
Assigning to products, and changing just one

Templates are put to use from a product's edit page: pick a dimension sheet, a materials & finish template, assembly info, delivery info, Q&A entries, room scenes and sets. Save and it's live on the product page.

When one product needs different content while everything else keeps the shared template, use an override. Only that product gets the custom content — the template and every other product using it are untouched, and later edits to the template won't overwrite it.

When one dimension sheet is shared by several products, “Sizes shown on this product” in the product editor picks which of the sheet's sizes that product actually sells and what it calls them. The numbers stay shared with the sheet, so fixing the sheet still reaches every product.

To assign to many products at once, use Assign / Unassign (Pro). Only the fields you choose are replaced; anything you leave unselected keeps its existing assignment.

Screenshot coming soon — HOME-SHOT-10 Assign to a product

Assembly & delivery templates

Answering "do I have to build it?" and "when and how does it arrive?". Assembly info and delivery info are separate reusable templates you assign to products. Free.

Build an assembly-info template Free

Assembly info holds whether assembly is required, roughly how long it takes, how many people it needs, which tools are involved, and a link to the manual. 8 presets cover the common build profiles in one tap, so you rarely start from a blank form.

Tools are stored as fixed codes (hex key, Phillips screwdriver and so on) and translated for each shopper's language. Anything not in that list is shown exactly as you typed it.

  1. Open Assembly info and add a template.
  2. Pick a preset, or fill in required / time / people / tools yourself.
  3. Save, then assign it to products from the product edit page.
Screenshot coming soon — HOME-SHOT-11 Assembly info
Build a delivery-info template Free

Delivery info holds the delivery method, whether setup is included, whether stairs are handled, the lead time, and a free-text delivery note. 5 presets cover the common delivery profiles.

The delivery note is stored separately from the numbers and codes, so Translate & Adapt shows it as plain prose — you never have to hand-edit JSON to translate it.

Screenshot coming soon — HOME-SHOT-12 Delivery info
Adjust assembly or delivery for one product Free

Assign a template on the product edit page and its values appear right there, editable. Change one and only the difference from the template is stored as that product's adjustment. Set it back to the template's value and the adjustment disappears by itself.

Creating and editing the templates themselves belongs to the Assembly info and Delivery info screens; the product page stays focused on assigning and fine-tuning.

Screenshot coming soon — HOME-SHOT-13 Per-product adjustment
Build a Q&A library Free

The Q&A library lets you save common questions and answers once and assign them to as many products as you like — up to 10 per product.

  1. Open the Q&A library and add an entry.
  2. Write the question and its answer, then save.
  3. Assign it to products from the product edit page (up to 10 each).
Screenshot coming soon — HOME-SHOT-14 Q&A library

Owner feedback & Pro features

The part that photos and numbers can't cover: what the piece is actually like once it's in a room. Room scenes, sets, owner feedback and the owner verdict are all Pro.

Add room scenes Pro

A room scene is a reusable template: a photo of the piece in a real room, plus the room type, its size in m², and a short note. It answers "will this overwhelm my living room?" with an actual photograph.

Up to 4 room scenes can be assigned per product. On the product page they scroll side by side, and a tap enlarges the photo.

Screenshot coming soon — HOME-SHOT-15 Room scenes
Create sets (complete the room) Pro

A set proposes the pieces that finish a room together. Each set can hold up to 6 products, and each product can carry up to 4 sets. On the product page it appears as "Complete the room".

Screenshot coming soon — HOME-SHOT-16 Sets
Owner feedback (firmness, color, assembly) Pro

On the product page, owners can vote on three axes with a single tap.

  • Firmness: softer / just right / firmer
  • Color: brighter than the photo / as pictured / darker
  • Assembly: easy / normal / hard

Voting is anonymous — only aggregate counts are stored. No personal information, such as names or order details, is ever saved. One browser can vote once per axis per product.

When the owner verdict appears Pro

Once votes accumulate, an owner verdict badge such as "sits as described" appears on the product page. It only shows when that axis has 5 or more votes (the default; adjustable from 1 to 30 in the block's theme-editor settings) and the trend clearly leans one way. With too little to go on, nothing is shown rather than something vague.

Before any votes arrive you can set a comfort hint — firmer or softer — per product from your own experience. It appears immediately as guidance, and real vote data takes over the display once enough of it accumulates.

Screenshot coming soon — HOME-SHOT-17 Owner verdict

Reading the returns data

The screen for checking whether improving your product information actually paid off (Pro). Importing is covered under "Data, export and handover".

Separating the returns information could prevent Pro

Imported reasons are sorted into four buckets: won't fit, colour & texture, comfort and damage. Only the first three are counted as returns better information could have prevented — damage is a shipping and packing problem, not something the product page can fix.

Damage is matched first, deliberately. A damaged delivery is routinely described in fit and colour words, so reading the text naively would file it as an information problem.

The figures cover the last 90 days, and the trend can be read by week, month or year. Which day starts the week is a Settings choice.

Screenshot coming soon — HOME-SHOT-24 Returns data
Comparing before and after Pro

Taking the day you edited a product's information as the dividing line, this shows how that product's return rate compares before and after — so "did adding the dimensions actually reduce returns?" is answered with a number rather than a feeling.

It is also where returns meet owner votes. If a product draws "firmer than expected" votes and comfort-related returns, the thing to fix may be the description rather than the product. The shortlist exports to CSV.

A comparison needs data on both sides. Soon after an edit there is not enough to judge, so the figure is left blank rather than guessed at.

Settings

The store-wide settings. There are deliberately few of them: fewer decisions, less to get wrong.

Input unit, doorway threshold, week start

Input unit is the unit you type dimensions in. It does not affect the storefront: shoppers see centimetres or inches depending on their country and can switch either way (storage is always centimetres).

Doorway-fit threshold is one of 70, 76, 80 or 90 cm. The default 70 cm is a Japanese interior door; 76 cm is a North American 30-inch door, 80 cm a European door, 90 cm a wide entrance. This setting decides whether the doorway check appears at all — only on products whose carton needs more than this. Set it too low and parcels start nagging shoppers; too high and the check goes missing on a sofa that genuinely will not fit.

Week starts on sets the buckets in the returns trend chart.

Screenshot coming soon — HOME-SHOT-25 Basic settings
Which sections show, their order, and renaming them

The row of tabs in Settings is the row of tabs on the product page. Drag to reorder, click a tab to rename it or switch it off. Put what your shoppers read most on the left.

Headings can be reworded into your own language — "Dimensions & doorway fit" can become "Size & delivery". A feature you switch off disappears from the storefront and from the dashboard's coverage figures alike.

A section with no data hides itself. Forgetting to switch one off never leaves an empty tab on the page.

Resetting one feature, and deleting everything

To clear out templates you only made to try something, use reset by feature. It empties the library for the feature you pick (dimension sheets, materials, room scenes…) and leaves the others alone.

Delete all data removes everything this app created. Because it cannot be undone, it will not run until you type the confirmation word.

Export to CSV before either one — export is available on the free plan. Note that uninstalling does not delete your data; only an explicit deletion here does.

Data

The operational side: exporting and importing what you've registered, analysing returns data, and handing everything over when someone new takes charge.

Export your data as CSV Free

Export everything you've registered as a CSV file. The columns are title, handle, dimension_sheet, material_profile, sets, room_scenes, faq, assembly_template, delivery_template, cleaning_code, rub_count, comfort_hint. References to dimension sheets and the other templates are handled by name, so re-importing the file links everything back up correctly.

Shopify's own standard product attributes (color, material and so on) are not part of this CSV — the app reads them straight from Shopify.

Screenshot coming soon — HOME-SHOT-18 CSV export
Import content by CSV Pro

Bring in dimension sheets and template assignments in bulk from a CSV file. The content is checked automatically before it's applied, so a wrong column name or an invalid value is caught before anything changes.

The usual workflow is to export, edit the file, and import it back. For a store with many products that round trip is the fastest route.

Screenshot coming soon — HOME-SHOT-19 CSV import
Import returns data and see what it says Pro

Import your past returns as a CSV and the app sorts the reasons into won't fit, color & texture, comfort and damage, so you can see which products to fix first.

The import uses just two columns — the product handle and the return reason — and contains no shopper personal information: no names, addresses or order numbers. Reasons can be plain sentences. The app never reads your orders.

Results, plus the recent trend, live on the Returns data screen. Where "won't fit" tops the list, filling in packaged sizes and the doorway-fit check is what moves the number.

Screenshot coming soon — HOME-SHOT-20 Returns data
Generate the handover guide

The handover guide gathers your current settings, data status, what each screen does, and the day-to-day routine onto a single page. When someone new takes over, print it or save it as a PDF and it doubles as your handover document.

Screenshot coming soon — HOME-SHOT-21 Handover guide
Multilingual support (Translate & Adapt)

To translate the text in dimension sheets, materials & finish, assembly and delivery info, room scenes, sets and Q&A, use Shopify's standard Translate & Adapt app. Mitasu has no translation screen of its own — Translate & Adapt is the single hub.

The admin marks which fields are translatable. Fields that must not be translated — the category and material codes that decide what the product page draws — are flagged as such.

Screenshot coming soon — HOME-SHOT-22 Multilingual support
Let a connected AI assistant help

Because all of your data lives in your Shopify store's standard storage, an AI assistant connected to your store — Claude and others — can help create templates and assign them to products. For bulk changes, the app's own CSV export/import flow does the work, so large changes are checked and applied safely.

An AI never touches the products themselves. Creating, rewriting or deleting a product is explicitly forbidden in the guide — an AI can only change the dimension sheets and product information this app manages.

See the AI operations guide for the full walkthrough.

If you get stuck

If something doesn't appear on the product page, check these three things in order.

  1. The block is placed on the product page in the theme editor.
  2. The section is turned on in Settings.
  3. A template (such as a dimension sheet) is assigned to that product.

If you're still stuck, contact Support. Common questions are answered on the FAQ page.

What shoppers see

How what you entered actually appears to a shopper. Placing the block itself is covered under "Getting started".

The tabs, the units, and following the selected size

It is one block whose contents are split into tabs (Dimensions & doorway fit / Materials / Assembly & delivery / Room ideas / Real-world comfort / Q&A). Order and names come from Settings, and a tab with no data does not appear. In the theme editor you can choose tabs or a stacked layout.

Units open to suit the shopper — inches and pounds in the US and Canada, centimetres and kilograms elsewhere — and a toggle switches them at any time.

When a shopper picks a variant, the matching row of the size table lights up. Map the sheet's row names to the product's variant names and it is immediately obvious which numbers to read.

Screenshot coming soon — HOME-SHOT-26 Product page
How the doorway-fit check behaves

The delivery zone opens with the opening it needs — the carton's narrowest side plus a 2 cm margin. As the shopper types their door width and height, the verdict updates on every keystroke. Hallway corners, lifts and stairs are picked only if they apply, so nobody faces eleven questions at once.

The arithmetic runs entirely in the shopper's browser. What they type is kept on their own device (ready next time) and is sent neither to your store nor to us. The page says so.

The verdict is labelled as guidance based on packaged sizes, with corners, ceilings and stairs called out as things it cannot promise. Not overclaiming is what keeps the follow-up questions down.

Troubleshooting

In the order they actually come up. Nearly all of them are a setting, or a field nobody filled in.

Nothing appears on the product page

Work down this list.

  1. The block isn't placed. Settings → "Add to your product page" opens the theme editor; press Save at the top right. The dashboard also flags this until it is done.
  2. Nothing is assigned to that product. Sections with no data hide themselves, so a product with no assignments leaves the whole block empty.
  3. The feature is switched off in Settings → "Sections to show & order".
  4. You changed themes. Block placement belongs to a theme; switch themes and it has to be placed again in the new one.
The doorway check is missing, or the drawing is wrong

If the check is missing, the cause is almost always the packaged sizes: check that all three sides are filled in under "Size of the box it ships in". Even then, a carton at or below your Settings doorway width (70 cm by default) deliberately collapses to a single line. The sheet editor tells you which of the two the current boxes will produce, so you can settle it without opening a product page.

If the drawing shows the wrong furniture, check the sheet's category. One thing to know: translating the category value in Shopify's Translate & Adapt makes the app stop recognising it. When that happens the app drops the figure and shows the table alone rather than draw the wrong piece of furniture. Leave the category untranslated.

The setup screen appears, or fields are missing

The setup screen right after install is normal: the app is creating the roughly forty containers it stores data in, which takes about ten seconds. A store that has finished it never sees it again.

If an app update adds a field and it does not appear in your admin, run re-check from Settings. It recreates only the containers that are missing and leaves your data alone.

If that does not settle it, write to support@mitasu.tech with your store domain and what you are seeing.