Know what an AI edit costs before you ask for it

What each plan includes

Every plan includes AI page edits, and the allowance belongs to the website rather than to you.

Enterprise is sized to how you use it. It starts at 400 credits per monthly billing cycle, and your Mirin contact can set a larger allowance for your account when you agree your plan together.

How to make an AI edit

An AI edit starts on the field you want changed, so you point at the words rather than describing where they are.

Pick a choice and the new copy appears on the page immediately, so you are judging the real design rather than a preview. If you do not like it, use Undo and your original text comes straight back. What it used is spent either way, which the panel says out loud. If you have already closed the tab, there is a named restore point waiting for you: see Getting an AI edit back.

It reaches the writing wherever it lives, not only the settings at the top of a section.

• Settings inside a group. A heading that sits inside a group of settings, such as Main Heading on a hero, gets the action on the heading text itself while its colour beside it does not.
• Every entry in a list. Each FAQ answer, each testimonial quote and each feature description has its own action, and rewriting one leaves the others exactly as they were.

Fields the assistant stands back from

The action appears on text and paragraph fields. Where it is missing from something that looks writable, the field says why rather than staying silent.

Pictures, colours and numbers

Fields holding an image, a colour, a number, or a live connection to a content list are left alone.

Formatted text

The fields with bold, links and lists say so under the field rather than staying silent: “Formatted text keeps its own links and styling, so the assistant does not rewrite it.”

Values your theme looks up

The Icon Name on a trust badge, or the Item ID and Handle on a menu entry. These hold something your theme looks up rather than words a visitor reads.

Links and addresses

The URL beside a footer link, a Button Link, a mailto: or tel: address, and the Auth API Endpoint a sign in section sends its requests to.

Dropdowns

A field your theme turns into a dropdown, such as Image Position, shows no action at all. There is nothing to write, only a choice to make.

Two of those refusals are about the damage a plausible rewrite would do. Rewriting MapPin into “Map Pin” reads like an improvement and renders as a blank icon, and a warmer version of an endpoint would stop customers logging in. A field holding a link says so in as many words: “This holds a link rather than words on the page, so the assistant leaves it alone.” A warmer version of a destination is simply a different destination. The words next to them, the link title and the button label, still get the action.

Shared sections

Shared sections such as your header, navigation, and footer are left alone. Their wording is the same on every page that uses them, so the assistant does not rewrite it from one page. The field says so in place of the action.

There is a second door, and it is usually the one you want. The lock is only on rewriting this page’s copy of a shared section, and you do not have to go looking for the way round it.

Until the page is saved, the section is still the shared one everywhere, including here, and asking for a rewrite answers “Your copy of this section is no longer shared, but the page has not been saved since.” Once the page is saved, Rewrite with AI works on that section’s fields like any other.

If your website is on a plan without AI page edits, the same button opens a panel that says so and links straight to billing.

When the page itself cannot be changed

Two situations stop the assistant before any of the rules above apply, because they stop every kind of edit. In both, the action is still visible and still explains itself rather than disappearing, and no credit is ever spent.

You are looking at an older version

Open a version from History and the canvas shows that version rather than your page, so nothing on it can be edited, AI included.

The page is locked on your plan

If your subscription ends or your plan changes, the pages over your new limit are locked rather than deleted. Nothing is lost.

Both refusals open with the same sentence, because it is the same rule: “The assistant can only change a page you can change yourself.” On an old version it goes on to name it, “You are viewing version 41. Restore it to make changes.”, and restoring the version or closing the preview brings everything straight back. On a locked page it reads “This page is locked because your subscription ended. Open your Pages list to choose which pages stay active, or upgrade to unlock all of them.”

The refusal comes before the click on purpose. The price is never offered on a page that cannot be written to, so you cannot spend a credit, watch the words arrive, and then be told the page could not be saved.

Choosing Standard or Best

Every AI action in the editor runs at one of two qualities. Standard is the default and suits most edits. Best does the same job with stronger models and costs more credits each time, so you save it for the pages that earn their keep.

The quality button is one small icon, and the icon is your choice: an outline bolt means Standard, and a filled blue sparkle means Best. Point at it and it says “Quality: Standard” or “Quality: Best”. Click it and a menu opens above it with both choices, what each is for, a rough cost, and a check beside the one you are on. Under them it says “The exact cost shows before anything runs.” Pick one and the price beside the button changes at once, so you see the most the action can cost at that quality before you spend anything.

On the price line of every AI panel

The button sits at the end of the price line, so the price beside it is always the price for the quality you picked.

Beside the picture description box

Find a picture with AI puts it next to the optional description, and both button prices follow it.

In the chat toolbar

Under the chat box it sits next to the usage gauge, and the price on the Send button follows it.

One choice for the whole editor

Switch it in one place and every panel and the chat use it too, so you are never quoted one quality and charged another.

• Remembered for you. The editor keeps your choice for you in this browser, so it is still set the next time you open a page.
• Not for your teammates. A teammate editing the same site keeps their own choice, and a different browser starts at Standard.
• Open to every site with AI. Best is on every paid plan, and on a free site that has AI credits. Where Best is not offered, its row stays in the menu, greyed out, and reads “Not available on this site yet.”

What actions typically cost

Credits price the task and quality you choose. Provider tokens are part of Mirin's delivery cost and do not set your bill. A model substitution alone does not change the price for equivalent work.

These are examples from the initial customer schedule. The editor shows the current price before you act. A single delivered unit costs its quoted price; a batch maximum falls only when some quoted units are not delivered. Three takes is one complete set and is refunded if fewer than three usable takes arrive.

Getting an AI edit back

There are two ways back, and they answer different questions.

You do not have to go and look for the restore point either. The panel names it as soon as the edit lands, on the line under Applied to the page: “Saved ‘Before AI changed Hero Banner’ in History, so you can put this back later.” In History it is called Before AI changed Hero Banner, with the line “Restore point taken before AI changed the wording in Heading Text on Hero Banner.” underneath and an AI restore point badge beside it.

• It holds the page as it was on your screen. Not the last time you saved. Anything you had typed and not saved yet is in the restore point too, and so is every AI edit already on your page in this sitting. Restoring one takes back that one edit, not your afternoon.
• A restore also puts the panels straight. A panel that was still confirming an edit, showing the Applied to the page line and an Undo beside it, stops confirming it when the restore takes that edit off the page: “A restore replaced this page, so that edit is no longer on it. Restoring does not give the credits back.” A panel about a section your restore did not touch is left alone, because nothing it says has stopped being true.

Seeing which words the assistant wrote

A section the assistant has written carries a small sparkle beside its name in the section list. Hover it and it tells you the day it was written: “Written by AI on 31 Aug. Edit this section yourself to clear the mark.” Before you save, it says “Not saved yet” as well, so you can tell an edit that is only in this tab from one the site has already recorded.

• Outline counts them. The same mark shows in Outline, at the top of the section list, which is the fastest way to see the whole picture on a long page. It counts the sections up front, as “13 sections · 1 written by AI”.
• It clears itself. Edit that section’s copy yourself, or undo the rewrite, and the sparkle goes out, because the words are yours again. Moving a section, renaming it, or changing a colour leaves it alone, since none of those change what the section says.
• A restore only touches what it changed. One the restore puts back holding the assistant’s words keeps its sparkle, one it puts back holding yours loses it, and a section the restore left alone is left alone here too. That is still true after a reload, because it is what your site has recorded.
• Your teammates see it too. The mark is recorded on your site rather than in the browser, so it survives closing the tab and a teammate opening the page tomorrow sees the same thing you do.

Where to start when you do not know what to type

The hardest part of asking software to write something is the first sentence. Mirin’s answer is not to write it for you.

Every AI panel in the editor is the same four things in the same order. Rewrite section, Describe a section, Plan this page and Build a component all open this way, and no panel opens with an example business.

The grey text says what the answer is made of

Instead of an example business, each box describes the shape of its own ask. Plan this page says “What the business does, and what this page should get a visitor to do.”

Rewriting a section is the exception, and it is buttons

Click a section already on the page and you get the rewrites worth doing to that particular section, each saying how much it covers: “Says the same in fewer words. Covers 7 pieces of copy.”

One button on a section decides which gesture you meant

A section used to carry two AI buttons, “Rewrite section with AI” and “Change this component”. It carries one now, so you never have to know which you need before you ask.

Describe a section says “A row of short quotes from customers, with their first names.” Build a component says “A band of three shipping promises, each with a short line under it.” None of them invents a trade, a town or a company, because a fake business in a placeholder is the assistant saying out loud that it has not looked.

The rewrites offered on a section you clicked are not suggestions about your business, they are measurements of the section you clicked. A choice that would mean nothing there is not offered, and a section whose only wording is a four word button label is never offered a shorter version of it.

Nothing here is a guess about your business

Nothing here is a guess about your industry

Mirin does not know what you sell, and it does not pretend to. No panel opens with a suggestion assembled from what it imagines your business to be.

The panels name your site rather than saying “your site”

Describe a section says “Picks from the 49 components installed on Salt & Stone Pilates”, and Build a component says it will install the new component there.

Where a panel does say something concrete, it is a measurement: the number of components installed on your site, the pieces of copy in the section you clicked, the settings a component declares. A site you have not named yet says “this site” instead. That number and that name are how you can tell at a glance that it read yours.

What the assistant is actually told

When you describe a section, three things go with your description.

• The page title. The title of the page you are on.
• The sections either side. The names of the sections on both sides of the gap you pointed at.
• Your component list. The components installed on your site.

Your page’s copy is not sent. The assistant is told plainly that it may not invent a price, a statistic, a date, an award, a guarantee or a customer quote, and that when it cannot write something honestly it must leave your theme’s placeholder in place rather than make something up.

Wherever a panel does offer you something to click, clicking it never spends a credit. It writes into the box and leaves the cursor at the end of it, because the part that makes the copy sound like your business is the part only you can add.

What you can ask for

Open Rewrite with AI under a field and four choices are waiting, each one a different kind of change.

Shorten

Says the same thing in fewer words, keeping every fact and name.

Make it clearer

Rewrites it for a first time visitor. It never adds a claim that was not already there.

Add detail

Adds one or two sentences that follow from what you wrote. It never invents a price, a statistic, a date, a guarantee, or a customer quote.

Fix spelling

Corrects spelling, grammar, and punctuation. Nothing else changes.

Make the change now, or see it first

The chat’s send button carries a mode, next to the quality. It has two settings and it decides what pressing send actually does.

Plan is for the sentence you are not sure about. You get the change restated in one line, with nothing done to the page, and either press the button or type it differently. Reading the sentence costs the same in both modes, because in both modes it is read once.

When the assistant cannot read what you typed

An assistant that answers everything confidently is not being helpful, it is being agreeable. Typing a few stray characters into the chat used to produce a whole page plan, invented out of nothing, because the only thing able to answer had no way to say it did not understand. It has three ways now, and it uses them.

“I didn’t follow that.”

The message was not a request: a few stray characters, something pasted by accident, words that name nothing. The rest of the sentence names the sections on the page you are on, so you can see what there is to ask for: “On this page I can change the Hero, rewrite the Services, or add a section.”

“I can do that, but I need more to go on.”

Plainly about your page, but not enough to act on. “Make it better” gets this. If you named one section it says what you can change about that section; if you did not, it lists what the page has.

“I only work on this website, so that is not something I can help with here.”

A real question that is not about building your site. It is the same sentence every time, whatever you asked, because nothing about that answer is written by the assistant.

None of these three is written by the assistant. Each one is a fixed sentence, filled in with the names of the sections on your page and nothing else, so what comes back cannot be steered by what went in and cannot invent a section your site does not have.

If you meant something real and got one of these, say it with a section in it: “change the heading on the hero to Winter hours” rather than “fix the top bit”. Naming the section is the single thing that most often turns an answer like this into the edit you wanted.

Reviews and details are always your own

Supply the real reviews and service details you want visitors to see. Mirin checks generated copy against the information you provide and leaves spaces when details are missing. Review the result before publishing.

• Only reviews you gave it. A review you typed into your request, attached, or typed onto your website yourself goes in word for word, with the real name beside it.
• A space everywhere else. A new reviews section arrives with “Paste a real review from a customer here.” and “Customer name” in each card, and the assistant tells you it left spaces.
• No made up ratings or numbers. Star ratings, review counts, averages, press quotes, client logos and figures like “500+ happy customers” are left as spaces for you to fill in.
• No made up offerings or details. A services list, a price table or an events page gets only what you named or your site already says. Anything else reads “Add something you offer”, “Add what’s included” or “Add the price”, and a price, time or group size inside a sentence is bracketed the same way.

Removing, moving and placing sections

Tell the chat to take a section off, move it, or put a new one in a particular spot, in the words you would use out loud.

• Take a section off. “Remove the Harvest Club reviews”, “delete the map” or “we don’t need the newsletter signup”. The section comes off the page and nothing new is written in its place. The chat answers “Removed Harvest Club reviews. Undo brings it back.”
• Move a section. “Move Shop by style so it sits right above the FAQ”, “put the testimonials after the hero” or “move the map to the bottom”. The chat says where it went, for example “Moved Shop by style above Questions we hear a lot. Undo puts it back.”
• Say where a new section goes. “Add a gift guide right after Bottles We Keep Reaching For”, “above the FAQ” or “at the top”. A new section, a section of your products and the rows of a planned page all land there. Say nothing about where and they land at the end of the page, above the footer, as before.

Removing is not replacing

Say what goes in its place, such as “replace the reviews with a gift guide”, and the chat writes a new section there instead. That is priced as a new section.

Your header and footer stay put

The chat moves the section you named. It never moves your navigation, announcement bar, footer or cart unless you ask for that one by name, and a new section never lands above the navigation or below the footer.

Name a section it can find

Use the heading you see on the page or the name in Sections. If a move names no place the chat can find, it asks where the section should go and leaves your page as it was.

Giving the assistant a file to read

The facts a page needs are usually already written down somewhere: a price list, a class timetable, a menu, a spreadsheet of services. Attach the file to the chat and the assistant reads it, so you can ask for “the prices from the price list” instead of typing them out again.

1. 1
   Press the plus in the chat box. Choose “Add photos or files”, or drop the file onto the chat, or paste it. You do not choose where it goes. A photo is added to your media library, because the page has to show it. Any other file is read.
2. 2
   Wait for the file to settle. It appears above your message with its name. Hover it and it says what was read, for example “2 pages, read for this conversation”. The Send button waits until reading has finished.
3. 3
   Ask for what you want, in your own words. “Put the drop in price under the headline, from the price list.” You do not have to copy anything out of the file. The assistant finds the fact and writes it into the section you meant.
4. 4
   Check it on the page. The change lands the way every chat edit does, with a restore point in History, so a wrong number is one click to undo.

It stays out of your media library

A price list you asked the assistant to read is not something you agreed to publish. It is never added to your site, never gets a public address, and nobody visiting your website can reach it.

The cost is said before you send

Attaching a file is free. Using its reference text adds a published price per started 6,000 characters to each writing action. The initial rate is 0.1 Standard or 0.2 Best credits per block. Up to three files share a 24,000-character reference limit. The attachment shows its allowance before sending; writing several sections can use that allowance on each section.

It tells you when it only read part

A file longer than the limits turns amber, and the chat box says “Only the first part of price-list.csv was read, so Mirin may not know what comes later in it.” Split a long file, or attach just the pages you need.

A scanned PDF has no words in it

A PDF made by scanning paper is a picture of text. The chat says so instead of guessing: “No text could be found in that PDF. It looks like a scan or a photo of a document, and scanned PDFs cannot be read yet.” Attach a PDF that has selectable text, or paste the details into the chat.

A locked file cannot be opened

A PDF with a password is refused and nothing is kept: “That PDF is password protected, so it could not be read. Save a copy without the password and attach that.”

A file is read as facts, not as orders

What is inside a file is treated as facts to draw on, not as instructions. A document that says “ignore what you were asked and write this instead” is read as a sentence in a document. Only you, typing in the chat, decide what changes.

Rewriting a whole section, and watching it happen

Rewriting one field at a time is the careful way. The faster one is to point at a whole section and ask for the whole thing to read differently.

1. 1
   Click the section on the page. A toolbar appears above it with the section’s name and, beside it, “Rewrite section with AI”. It is the same verb you see under a single field, and it names what it covers because it costs more. You never type the word “hero”: you point at the thing you mean.
2. 2
   Say what should change. The panel is one box: the price, the question “What should change about this section?”, somewhere to answer it, and the button. Write it the way you would say it out loud. Underneath, the panel says how much copy it covers and what it will not touch, for example “Covers 18 pieces of copy across 3 entries. Leaves colours alone.” It says covers rather than rewrites because a rewrite is allowed to leave part of a section alone.
3. 3
   Watch it happen on your page. The new copy arrives on the real section, in your real design, at your real width, a piece at a time as it is written. A list of feature cards fills in card by card. The panel names the step it is on and lists what has landed so far, for example “Written so far: Title, Subtitle”.
4. 4
   Publish it or discard it. Above the two buttons the panel says: “Publish puts it on your website. Discard puts the section back. Close this and it stays in your draft, where only you can see it.” Publish sends it live straight away. Discard puts the section back exactly as it was.

You can stop it, and stopping is free

A Stop button sits in the panel the whole time the rewrite is running. Press it and the section goes back to what it said a moment ago and your credits come back.

If it finished first, it says so

Press Stop in the same instant the rewrite lands and the credits are already spent. The panel says what did happen rather than showing a refund that did not.

Nothing reaches your website until you publish

The new copy lands in your draft, which only you can see. Your website changes when you press Publish in the panel, or Publish changes in the top bar later.

The numbers add up

Afterwards the panel measures the rewrite against the number the chip quoted: “That is 3 of the 9 pieces of copy this rewrite covers”, and under it “6 pieces of copy were left alone”.

It says what it left alone

Pictures, colours, links, dropdowns and anything connected to a content list keep what they had. They are counted separately, as settings rather than as copy, and each one gives its reason.

Some connections are slower than others

If your connection or ours cannot send the rewrite a piece at a time, it arrives all at once instead and the panel says so. Same edit, charged the same way, no animation.

Stopping quotes the refund back to you: “Stopped. Your page is exactly as it was, and your 0.1 credits came back.” Press Stop in the same instant it lands and the panel says instead that the rewrite had just finished, that the credits were used, and that your page is still exactly as it was. Nothing is ever written by stopping.

Checking the receipt

The two counts always add up to what the rewrite covered, so you can check it without doing any arithmetic of your own, and the restore point it saves in History counts the same way. A setting it left alone gives its reason, for example “Hero Image is chosen rather than written, so a wording change leaves it as it is.” Pictures have their own action under the picture setting itself: see Finding a picture for a section.

Adding a section by describing it

The other way to use AI in the editor is to add a section that is not there yet. You describe what goes in the gap, and working out which of your components you meant is part of the price.

1. 1
   Point at the gap. Hover the space between two cards in the section list. The blue plus button appears, and beside it “Describe a section”. The plus button is the component library and is free; the other one is this. It is the only AI button in the gap, because a gap is a place and this is the gesture that is about one.
2. 2
   Say what should go there. Write it the way you would say it out loud: “a row of short quotes from customers who love our wine club”. You do not name a component. Working out which one you meant is the job.
3. 3
   Look at it on the page. The section appears in the gap you pointed at, filled with copy about your business rather than the placeholder text a new section usually arrives with. It is in your draft, where only you can see it.
4. 4
   Publish it or discard it. The panel says: “Publish puts it on your website. Discard takes it off the page. Close this and it stays in your draft, where only you can see it.” Publish sends it live straight away. Discard takes it off the page and your page is exactly as it was. Either way, a section you leave on the page edits like any other, by hand or with the AI gestures.

It only uses sections you already have

The panel says which pool it is choosing from, and names your site while it does it: “Picks from the 40 components installed on Salt & Stone Pilates”.

It says no rather than guessing

Ask for something your theme has no component for and you get told, in as many words, and nothing is charged.

A section it cannot write is not one you pay for

Occasionally the closest component turns out to be one the assistant cannot write from what you said. You are told which one it was, and that nothing was charged.

It tells you which part it could not do

If a component covers most of what you asked for but not all of it, the panel lists the rest. “These quotes cannot carry a video” is better than quietly leaving the video out.

The theme keeps its own look

Colours, links and dropdowns keep the values your theme ships. The assistant writes the words, and the panel says how many settings kept the theme’s own values and why.

A site you have not named yet says “this site” instead. The assistant cannot invent a component, because one your theme does not include would publish as an empty gap on your live site.

When the closest component is one it cannot write from, you are told that this site may have nothing that does what you asked. Adding a section from the plus button is always free, so that route stays open. Pictures work the same way as they do in a rewrite, and they have their own action: see Finding a picture for a section.

Discarding does not give the credits back. What it used paid for the writing, not for the decision, and the panel says that while the Discard button is still under your cursor.

Planning a whole page before it is written

When the page does not exist yet, describing one section at a time is the wrong shape. Planning proposes the whole page as a list of sections first, and writes none of it. You edit the list, read the price for the whole run, and then decide.

The panel is deliberately just that question and a box, with no suggestion above it, because this is the gesture that shapes a whole page and the sentence has to be yours. The grey text in the box says what a brief is made of: “What the business does, and what this page should get a visitor to do.”

1. 1
   Say what the page is for. Press “Plan this page”, beside the Page Components heading in the section list. It is a page level gesture, so it is offered once, with the page, rather than in every gap between two sections. One sentence about the business and what the page should get somebody to do is enough.
2. 2
   Read the list. You get the sections the page should have, in the order a visitor reads them, each named the way you would name it rather than by component. Beside each one is the component from your own site that will render it, and the most writing it can cost.
3. 3
   Change it. Take a row out. Move one up or down. Retype what a section is or what it should say. Point a row at a different component your site has. The price under the button follows every edit, so the number you press is the most you can be charged, and each section is charged what writing it used.
4. 4
   Write it. The button names the size of the job: “Write 5 sections”. Sections appear on the page one at a time as they are written, and Stop ends the run after the one in flight. When it finishes, the panel says: “Publish puts them on your website. Discard takes every section this run added off the page in one step. Close this and they stay in your draft, where only you can see them.”

It tells you what your site cannot do, before you pay for it

Every row is checked against the components installed on your site while the plan is being made. A row nothing fits stays in the list, marked, and priced at nothing.

A row it cannot fill names the closest thing

When something on your site is close without being the thing, the row says which: “The closest this site has is Subscription Signup.”

Navigation, footers and cookie banners are not written per page

Those are shared across your whole site: one definition, and every page follows it. So a row for one of them is skipped like a row nothing fits, priced at nothing, with the reason on the row.

Nothing runs without the plan

The writing step will not run without the plan that produced it, and that is enforced on our servers rather than by hiding a button. A plan is good for thirty minutes and belongs to the page it was made for.

A row that fails costs nothing and does not stop the rest

If one section cannot be written, you are told which and why, its credits are not taken, and the other sections still land. Four sections on the page beats nothing on the page.

On a row that names a near match you can point the row at it yourself if you agree, leave the gap, or press the row’s own Build button and have the missing component made.

A shared row stays skipped even when your site does have a footer component and the plan found it, because writing one into a single page would put a second copy beside the one every page already shares. It is never offered a build either, for the same reason. If you meant something else by that row, point it at the component you meant from the row’s own menu and it is written like any other. Otherwise, edit your real one once and every page picks it up.

Having the one nothing fits built

You are never limited to the components you already have

A row nothing fits carries its own button, “Build one · up to 0.4 credits”, so the answer to a gap is on the line that has the gap. A row that did find a match offers the same from the foot of its component menu.

Building one places nothing on your page

The build installs the component and stops there. It does not drop a section onto the page for you to publish or discard.

A row landing on Hero Banner is a row the assistant could fill, which is not the same as the one you wanted. Either way Mirin writes, builds and installs a new component for your site from what that row already says, then points the row at it. The build is priced where it is offered and the writing is priced with the rest of the run, so you see both numbers before either is spent. If your remaining credits will not cover a build, the button says so and names the shortfall rather than failing after you press it.

The build stops once the component is installed because the plan you are already reading is the decision, and a section landing mid plan would be written a second time by the run. Your page changes when you press the button at the foot of the list, and not before.

Discarding a finished run takes every section it added off the page in one step, but it does not give the credits back. Each delivered section uses its accepted quoted price. Publish sends the whole page live straight away. Close the panel instead and the sections stay in your draft until you press Publish changes in the top bar. Free sites can design with their credits and save drafts. Publishing requires a paid plan.

Having a new component built

Sometimes the section you want is not one your theme has. Build a component writes a brand new component for your site, builds it, installs it and puts it on the page.

Free sites can build sections with their available AI credits and save drafts. Publishing the page requires a paid plan.

1. 1
   Press Build a component, beside the Page Components heading. Build a component makes something for your whole site rather than for one gap, so it sits with the page, next to Plan this page. The new section lands at the bottom of the page and the panel says so before you press anything. On a page with nothing on it yet, all three doors are offered together in the empty state instead.
2. 2
   Describe what it should be. Write it the way you would say it out loud: “a band of three shipping promises, each with a short line under it”. Say what goes in it, not how it should be coded.
3. 3
   Wait for it to be built. The panel says which part it is on: writing the component, building it, installing it on your site.
4. 4
   Publish it or discard it. The new section appears where you pointed, with real copy in it, already in your draft. Publish sends it live straight away. Discard takes the section off the page and leaves the component installed, so you can add it again from the plus button whenever you want. Close the panel instead and the section stays in your draft, where only you can see it, until you press Publish changes in the top bar.

It is a real component, not a picture of one

What you get is the same kind of thing your theme ships: source code, an editable list of settings, and a bundle your live site loads.

You can edit it like any other section

It appears in the section list under its own name, with its own settings panel. Every setting is editable by hand, and the AI gestures you already use work on it straight away.

It belongs to your site

The component is installed on the website you built it on and appears in that site’s component library from then on. You can add it to any page. It is not shared with anyone else’s site.

It keeps its own styling

A built component brings its own layout and spacing and takes its colours from settings you can change. It does not reach into the rest of your theme, so adding one cannot change how your existing sections look.

What it will not do

A built component is a presentational section: copy, pictures, colours, layout. It does not connect to your Content Lists or other live data. To show your store’s products, ask the chat for them instead: see Adding your products from the chat.

Every setting it renders is a setting you can edit

A component is only built if the list of settings it declares is exactly the list its code reads.

A build that fails costs nothing

Every way this can stop gives every credit back: the assistant writing something that would not build, a component that renders nothing, an upload that fails. The panel says so in the same sentence as the refusal.

Mirin builds the component and checks that it actually renders before it is added to anything. If it does not render, nothing is installed and nothing is charged. Once it is yours you can rewrite the whole section, rewrite one field, or find a picture for a picture slot, without saving first. What it cannot do is carry interactive behaviour like a form or a slideshow. Those need a component built by a developer, or one of the ones your theme already ships.

Discarding does not give the credits back, and it does not remove the component. What it used paid for having it built, and you still have it.

Changing one you already have

Once a component exists, changing it is a different gesture with the same most it can cost, and it is behind the same button as everything else you do to a section. Point at any section, press Rewrite section with AI and say what you want. If the words cannot do it, the panel offers Change the component instead, which rewrites and rebuilds the component you already have, so the change lands on every page using it rather than adding something new. It works on the built ones and on the ones your theme shipped, including the shared sections a rewrite will not touch. See Changing a component with AI.

Finding a picture for a section

Rewriting words leaves the pictures alone on purpose: asking a section to sound warmer should not quietly swap a photograph. Pictures have their own action instead.

The studio

Come in and say hello.

Sections

Value Proposition

Section Image

Find a picture with AI

Quality: Standard

Use one of my pictures

Up to 0.1 credits. 96 of 100 left in your rolling 30 days.

Make a new picture

Up to 2.8 credits. 96 of 100 left in your rolling 30 days.

Open any picture setting in the section list and there is a “Find a picture with AI” line under it, with two ways to answer and a price on each.

You can add a line of your own before either button, the way you would tell a photographer: “something showing the wine itself”, “the shop front on a bright autumn morning”. It is optional. Without one the assistant reads the words already in that section and works from those.

It never goes looking on the internet

Every picture it can put on your page is either already in your Media library or was just added to it. Nothing is hot linked, so a picture cannot disappear later because a site you have never heard of took it down.

Both prices are on screen before you click

Each button has its own price and what you have left under it, at the quality you chose. If you have enough for one and not the other, the one you cannot afford says so instead of taking the click and refusing.

A picture it could not make is not one you pay for

If the picture cannot be made, or cannot be saved to your library, you are told in a sentence, nothing is changed on the page, and the credits come back. It will not leave a broken image behind.

Try another never shows you the same one twice

If you like the words and not the photograph, press Try another. It asks again with everything you have already turned down taken off the list, and it does not touch anything else in the section.

Some themes keep descriptions somewhere else

A few themes store a picture’s description in its own separate setting rather than with the picture. When yours is one of them the panel says so.

Undo puts the old picture back, credits stay spent

Undo restores the exact picture that was there, with the description you had written on it.

A theme that keeps descriptions in a separate setting says so, because otherwise you would think your site had a description it does not have. Undo puts the old picture back, and the credits paid for finding the picture rather than for the decision to keep it, so a generated picture stays in your Media library either way.

Like every other AI edit, the picture is applied to the page but not saved. Press Save when you are happy with it, and use History to go back further than one Undo: the restore point it leaves behind says which section the picture changed on.

Asking about your store

If your site has a store, you can ask the chat about it in your own words: “how many orders did we get in the last 2 days?” or “who were my best customers in the last 30 days?”.

• Orders and sales. How many orders came in, net sales and the average order for any window you name, by day, week or month, for one collection, or compared with the period before. A comparison covers the same span: this week so far is compared with last week up to the same day and time, and the card names those dates. If you sell in more than one currency, the answer shows net sales and orders for each currency.
• Best sellers and products. Your best sellers overall or in one collection, and which products are listed in a collection, under a price or matching a word.
• Stock and collections. What is out of stock or running low, and how many products each collection lists on your site.
• Customers and discount codes. New and returning customers, your best customers by spend, which codes customers can use now, and how each code did.

Where do the numbers come from?

From your store, the same way Sales insights counts them: paid orders, with test and cancelled orders left out and refunds taken off on the day they happen, in your store’s time zone. Every answer ends with a line saying exactly what was counted and for which dates.

Can the assistant get a number wrong?

The assistant writes the sentence, but every number, date, price and product name in it is filled in by Mirin from what it counted. An answer that types a figure of its own is thrown away and written again, so the words and the card always agree.

What does a question cost?

The initial schedule charges 0.2 credits on Standard or 0.6 on Best for a delivered answer, on top of reading your message. Review the current quote before sending. Opening a screen or adding the products as a section from an answer uses none.

Can I stop a question?

Yes. Press Stop while the chat is reading your store and the question ends there. The question uses no credits, only reading your message stays charged, and nothing is added to your page. If the question had already run out of time when you pressed Stop, the chat says “Stopped. Nothing from that question was kept.”

Can I see the same answer over a longer window?

Yes. Under an orders answer, Show the last 30 days asks your original question again over the last 30 days, today included, the way Sales insights counts them (Show the last 90 days when you already asked for 30). Under an answer you got that way, Show the last 90 days still asks your own question, not the words on the button. It counts again, so it is charged like a question.

What if a product sold but is not on my site?

The answer marks it “not on your site”, and Add these as a section only includes the products a visitor can see.

What about questions my store data cannot answer?

Profit, traffic, abandoned carts, ad results and forecasts are not in your store data, so the chat says so instead of guessing and offers a button to the closest screen, such as Sales insights, Website insights or Orders.

Can a discounts answer become a banner?

Yes. When a code is live, the answer offers Add a banner for that code, which asks the chat for a promo banner naming it, the way you would.

Store answers and your customers

An answer about customers names them on your screen and nowhere else, and deleting a customer takes them out of every answer you saved.

Names stay with you

The assistant never sees a customer’s name or email, and a deleted customer reads “a deleted customer” in every saved answer and every new one.

Does the assistant see my customers’ names?

No. You see names in an answer about your customers, but the assistant writes that answer with a placeholder where each name goes, and Mirin fills the names in on your screen. Your later messages in the same chat never send those names to the assistant either. Emails and phone numbers you type in a question are masked before the question is kept.

What happens to answers when I delete a customer?

Every saved store answer that named them changes to “a deleted customer”, and new answers say the same. That holds when you delete one customer, tick several and delete them together, or remove all your customers under Data in your store settings. A customer removed for good stays “a deleted customer” in new answers, even though their orders still carry their email. If the saved answers cannot be updated right then, nobody is deleted and you are asked to try again.

Who can see store answers, and for how long?

Only the store owner, or Mirin support when you ask them to help with your account. Store answers are kept for 90 days.

Adding your products from the chat

If your site has a store, you can ask the chat for a section of your own products: “add the top 10 best sellers from our Red Wine collection to this page”, or “add a shop by style section with red, white and sparkling”.

It stays current

The section reads your store every time the page is shown, so a new best seller or a wine that sells out changes what visitors see without you editing the page again.

It uses your own collections

Name a collection the way you would say it. The chat uses it only when the name matches one collection. If it could mean more than one, such as Red Wine and Red Wine Club, the chat asks which one you meant and recommends one only when it is clearly the closest. A name that is nothing like any of your collections is said plainly, never swapped for an unrelated one, and Open Collections is one tap away.

It uses a section your theme already has

Products go into your theme’s product section and collections into its featured collections section, with the look you already have.

It can design one when your theme has none

The chat offers to design a store section, says the most it can cost before it starts, and asks which collection you meant first when a name could match more than one. Prices and titles in the section use your store’s currency, so a shop selling in euros gets a title such as Red Wine under €30.

It keeps showing if your store is slow

Publishing saves the products the section shows at that moment. If your store cannot be read when a visitor arrives, the page shows those instead of an empty space.

It lands on your draft

Nothing changes on your live site until you press Publish.

What can I ask for?

Best sellers, newest arrivals, products under a price, or products from one collection, 8 unless you name a number, up to 24 at a time. A few means 4, a handful 5, and several or some 6. For featured collections, name the collections in the order you want them. The tiles keep that order, even when the chat asks which collection you meant for some of the names. If you do not name any, the chat picks your largest collections and says so. A collection with no products yet stays in the section but is not shown, and the chat says so. Its tile appears by itself once the collection has products.

What if some of the names are not collections yet?

A featured collections section never waits on one name. Each question offers Leave this one out, and Use the best match for the rest when more names are waiting, which takes each clear match and leaves out the rest. You can type it too, such as “skip Chillable Reds, use the closest for the others”. The section is built from the collections you chose, and the chat names anything it left out so you can add those collections later.

Can I change the products afterwards?

Yes, for free. Right after a live section lands, the chat offers Show 12 instead when the section shows 8, or Show 8 instead when it shows any other number, and Pin these. You can also type the change, such as “show 6 instead”, “sort by newest” or “pin these”, up to 48 products. Ask for more than 48 and the chat asks you for a number up to 48 instead of making a paid edit. When you already said how many, such as “a few bottles”, the other size is offered but never marked recommended. These changes use no credits and undo like any other edit. If the page has more than one live section and you do not say which, reading your message is charged as usual. You can also select the section and open its Products or Collections setting.

Can I swap the products a section already shows?

Yes, including a list you picked by hand. Name the section by its heading and say what it should show instead, such as “change the wines in Cellar picks to our natural reds” or “rotate in some new bottles”. The chat reads your store: the collection you name, and words such as natural or organic as your own product tags or names, in stock, best sellers first unless you say an order. It keeps the section’s count unless you give a number, writes each product the way the section already shows them, and says how many changed. When a word finds nothing it says what it used instead, such as “I used your Red Wine collection, since nothing in your store is tagged natural”, and it never invents a product. Name two collections for one section and it asks which one. A live section follows the new rule from then on, and a heading the chat gave it, such as Best sellers in Champagne, changes with it. A hand-picked list is then offered Keep it current, which turns it into a live list that follows the same rule, or Keep these picks. Only reading your message is charged, and one undo takes it back.

Can the chat write the words on each collection tile?

Yes. Ask “give each tile in Shop by style a one line description that says what the style tastes like” or “call the Reds tile Bold reds”. The chat writes a title or a short description for each tile, one line of about 50 characters, and it is charged like any other change to a section. A tile always opens its own collection, so the chat never puts another collection’s name on it. Ask it to call the Riesling tile Rosé and it tells you to ask for a swap instead. The pencil beside each collection in its Collections setting shows the words the chat wrote.

Can the chat change which collections a section shows?

Yes. Say “swap Riesling for Rosé in Shop by style”, “add Sparkling to Shop by style”, “take Beaujolais out of Shop by style” or “put Champagne first”. The chat finds each collection by name, the way it does for a new section. A collection swapped in takes the old one’s place, and any words you gave the old tile go with it. When a name could mean more than one collection, such as three called Rosé, the chat asks which one and recommends the one with products in it. The change lands on your draft as one edit, so one Undo puts it back, and only reading your message is charged.

What if a section has nothing to show?

A store section with no products to show, such as best sellers from a collection that is sold out, is hidden on your live page so visitors never see an empty block. Your pages list marks a page that has one, and the Publish panel names the section and says why before and after you publish.

What if my theme has no product section?

The chat offers to design one for you and says the most it can cost in credits. Say yes and it builds the section and fills it from your store; say not now and nothing is spent. Press Stop while it designs and nothing is added or charged. If building had already started when you pressed Stop, the chat says so: that section is charged and kept with your components, but it is not added to your page. A section a developer adds to your theme later is used from then on.

What if my store data cannot be reached?

The chat says it couldn’t reach your store data just now and that you can try again. Nothing is added, designed or made, and nothing is charged: the reading of your message is given back.

Does planning a whole page work with my store?

Yes. When a planned row shows your products or collections, the plan offers to reuse the store section your theme already has or design a new one, and the row is filled from your store when it is written.

Changing your store from the chat

Ask for a discount code, a stock count or a change to a collection and the chat drafts it as a card. Read every row, such as the code, the amount, the variant, the location and the count before and after, then press the button on the card to make the change, or open the store screen to do it there.

• Dates are your store’s dates. The chat knows today’s date in your store’s time zone, so “ending 31 Oct”, “starting Friday” and “for the next two weeks” land on the days you meant. A code works through the whole of its end date, and a code for one day can start and end on the same date. A code set to start later begins working at checkout on its own that day. If its end date has already passed when you press the button, nothing is created and the chat asks you to ask again with a new date.
• Stock goes to the right location. If you do not name a location, the chat uses your only location, or the one location that already holds stock for that product. When it is stocked in more than one, or none of your locations holds it yet, the chat asks which one you mean. Naming an option or a location for a product that has none gets a sentence saying so, never a draft that quietly ignores it.

Can the chat change my store?

A few things, and only when you confirm. Ask it to create a discount code, publish or unpublish a product, add products to or remove them from a collection you made in Mirin, or set or adjust stock, such as “set Provence Rosé to 24” or “add 12 bottles of the magnum at the warehouse”. Refunds, cancellations, customer details, deleting and prices stay in your store screens, and the chat offers the right one, such as Open Orders or Open Customers.

What if I press the button twice?

The change is made once. A second press, or a press that is sent again after a dropped connection, gets the same answer and changes nothing more, so stock is never added twice and a code is never created twice.

How long does a draft last?

A day. A draft shows your store as it was when it was written, so after 24 hours the button changes nothing and the chat asks you to ask again, and the new draft shows the counts as they are now. If a count moved before you press it, such as stock someone sold, a draft that sets an exact number is refused and a draft that adds or takes away is applied to the count as it is.

What about products that come from Shopify or another platform?

The chat never changes them. Products, collections and stock synced from Shopify, WooCommerce, Magento or BigCommerce are changed on that platform and sync down to Mirin, so the chat names the platform, offers Open Sync settings, and leaves them alone. Nothing is ever written back. Discount codes you create in Mirin work either way.

A page for one collection

Every collection already has its own page at /collections/its-name, made from your collection page design. Ask “make a page for the Summer Sale collection” and the chat says so, then offers three choices: A landing page at /summer-sale makes a draft page at its own address with the collection’s products already on it and plans the rest for you to review, with the most the plan can cost shown before anything is charged; Change the design of every collection page opens that design; Open that page shows the collection’s page on your live site.

• Save a draft before publishing. Free sites can create and save a landing-page draft using their available credits. Publishing requires a paid plan. Change the design and Open that page work on any plan.
• One per collection. Pressing the landing page choice again for the same collection, even from another chat, opens the page it already made instead of making another. If you deleted that page, the next press makes a new one.
• Never an address a page already has. If /summer-sale is taken by any page, draft or published, the choice names the address it will use instead, such as /summer-sale-collection or /shop-summer-sale. Addresses your store already answers, such as /search and /checkout, are never used. When all of those are taken, the chat asks you to make the page under Pages and choose its address.

How credits are charged

Priced AI actions share the website's credits. Reading a chat request, planning a page and writing its sections are separate steps. Completed steps can remain charged if you stop or a later step fails. The examples below explain the units; always review the current in-product quote.

How is a credit charged?

Each task has a customer price at Standard and Best. The editor reserves the quoted amount before it runs, then charges for the units delivered at that accepted price. Undelivered units return their credits. A cheaper model or an internal retry does not change your price. A batch can cost less than its maximum when fewer entries or pictures are delivered. The current quote in the editor is the price to review before starting.

Does reading my message cost anything?

A little. Working out what you asked for is AI work too, so each message uses up to 0.1 credits on Standard, or 0.4 on Best. That price covers reading your message. When the answer is a plan to review, a section of your products, or a screen to open, nothing more is charged. A generated picture costs the most, because the image itself does.

Does changing my store from the chat cost credits?

Drafting the change uses up to 0.1 credits on Standard, or 0.4 on Best, because the chat reads what you asked for. Pressing the button on the draft to make the change uses none, and pressing it again changes nothing and costs nothing.

What one chat message can cost

The Send price covers reading your message. Some messages go on to a second step, and that step holds its own price, up to the most shown here, and is charged what it used.

Is anything charged after that?

Pressing a button on a store answer or a draft uses no credits: adding the products as a section, opening a screen, and making a drafted change. Pressing the button on a draft twice changes nothing more and costs nothing. A drafted change is good for a day, and one you come back to later is not made. Show the last 30 days under an orders answer asks your own question again rather than the words on the button, so it counts again and is charged like a new question. Writing a planned page, designing a store section and finding a picture each show their own price before you press.

What does Stop give back?

Whatever the step you stopped was holding. Stop a store question or a store change draft before the answer is written and it uses no credits; only reading your message stays charged. Stop a store section design before its build starts and nothing is charged; once the build has started, the section is charged and kept with your components. Stop a section rewrite while it runs and its credits come back. If the step had already finished or run out of time, the chat or the panel says so instead of showing a refund.

Reading your credit count

The counter and every price you see come from the same ledger, so the numbers add up.

What if a cost cannot be measured?

Almost every step reports what it cost, or is priced from the work it did, such as the words it read and wrote or the size of a picture it made. If a step ever reports nothing that can be priced, you are charged the price you were shown before you asked, and never more.

Why do some counts have decimals?

Because most work costs part of a credit. Every action is charged in whole tenths of a credit, so your counter can read “47.5 of 50 left”. Trailing zeros are dropped, so 47.50 reads 47.5, and what is left is always rounded down, so the counter never shows a credit you do not have.

How the limit works

The count is on screen before you spend it, it belongs to the website rather than to you, and it refills as your oldest edits age out.

Do I see how many edits I have left before I spend one?

Yes. The panel that opens on the field says “Up to 0.1 credits. 46 credits left.” before you pick anything, so you never discover the limit after writing a request.

Is the allowance mine, or the website’s?

The website’s. Everyone who edits the site draws from the same pool, so if a teammate used 20 in the last 30 days your counter shows 30 left. That is why the number can move without you doing anything. The editor re-reads it when you open the panel and when you come back to the tab, so what you are looking at is current rather than whatever was true when the page loaded.

When do credits come back?

Active paid monthly subscribers receive credits on their billing-cycle date. Unused credits last for one extra cycle only, then expire. Free customers have no rollover; other plans retain their displayed allowance rules.

What if my account has extra credits?

They are added to what you have left, so the counter shows both together. Every edit draws from your monthly allowance first and only uses extra credits once that is spent. Extra credits do not come back after 30 days the way your monthly allowance does.

Does a failed edit cost me a credit?

No. The price you were shown is held while the edit is being generated and only charged when you get a result. If the generation fails, all of it goes straight back.

What if the rewrite comes back exactly the same?

It is free. If the result comes back word for word the same as the text already in the field, it is discarded and the credits go back. The panel names the field and says it “already reads exactly that way”, so you know to ask for something different rather than clicking again.

When the allowance runs out

Nothing else stops working. Every other part of the page editor keeps going exactly as it did: components, content, publishing, and the rest are unaffected. Only the AI edit itself waits.

An action is also refused when it could cost more than the site has left, even before the counter reaches zero, because its full price is held before it runs. The refusal names the price and what is left, and a smaller action may still fit.

• Wait for the date the editor names. It is the next allowance date for your plan.
• Or move to a larger allowance. The editor offers the next plan up, never the one you are already on. On Enterprise, your Mirin contact can set a larger allowance for your account.
• Or use extra credits. Buy a credit pack or add monthly credits from AI credits. Edits carry on from pack credits once the monthly allowance is spent.

If you are asked to slow down

There is a short guard on how quickly one person can start new edits, because each one takes a few seconds to generate. If you hit it, the editor tells you exactly how many seconds to wait. It does not use up credits, and it only applies to you, not to your teammates.