Skip to main content
Catalog Builder turns a merchant’s existing menu into a Taliup catalog. You give it a source — a filled Taliup spreadsheet, or a menu photo or PDF handed to your AI assistant — and it produces a draft you review line by line before anything is written to the merchant’s account. Nothing reaches the merchant’s live catalog until you press Commit.
Taliup HQ Catalog Builder page with a connector card on the left, a spreadsheet upload card on the right, and a Recent builds list below

The Catalog Builder page showing the AI connector card, the template upload card, and the list of recent builds.

​
How to get here

Entities → open a merchant → Catalog Builder tab.

​
Access

If the merchant is outside your scope or does not have the Catalog feature, the tab returns you to Entities with an explanation.

​
The two ways to start a build

From your AI assistant

Drop a menu photo, PDF or unfamiliar spreadsheet into Claude and ask it to build the menu. Best for merchants who hand you a printed or photographed menu.

From the Taliup template

Fill the standard Taliup product spreadsheet and upload it here. Best when the merchant already has clean product data.
Both paths produce the same draft and use the same review screen.

​
Upload the Taliup template

1

Download the template

Click Download template to get BulkUploadTemplate.xlsx. It contains a Guidelines sheet plus Products, Attributes and Tags sheets.
2

Fill it in

Complete the sheets. The column reference is the same one merchants use — see Bulk Import.
3

Upload

Drag the file onto the upload card or click Choose Excel file. Give the build a name so you can recognise it later, then click Create draft.
4

Wait for the draft

The file is read in the background. The build moves to Ready for review and opens the review screen.
Only the Taliup template is accepted on this upload. For a menu in any other shape — a photo, a PDF, a competitor’s export — use the AI connector instead.

​
Size limits

The upload card states both limits: 20 MB and 2,000 items. A workbook is counted before it is stored, so an oversized file is refused straight away rather than failing later in the queue.
A catalogue over 2,000 items belongs in Bulk Import. It processes in batches, survives a restart, and hands back a spreadsheet of just the rows that failed. Catalog Builder is for menus you intend to read line by line.

​
Build statuses

​
Review the draft

The review screen is where the real work happens. It shows the whole proposed catalog and lets you correct anything before committing.
Catalog Builder review screen showing a validation banner, Menu / Attributes / Taxes / Tags / Units tabs, and a draggable tree of categories containing items

The Catalog Builder review screen with the validation banner, tabs, and the menu tree of categories and items.

​
Tabs

​
Decide what happens to each row

Every row — every item, category, attribute, tax and tag — carries an action. Catalog Builder compares every row against what the merchant already has and suggests a match. A coloured badge next to the action shows how confident the match is. Click the match badge to open the picker, search the merchant’s catalog yourself, and choose a different record. A match you pick by hand is locked and will not be overwritten by later matching.
Update existing changes the merchant’s live data. It only touches fields the draft actually carries, and it adds attributes, taxes and images rather than replacing them — but the name, description and price will be overwritten. Use Link existing when you only want to reuse a record.
This matters for photos. Link existing writes nothing at all, so an item image in the draft is discarded — the row warns you when that would happen. Update existing adds the photo to an item that has none, and leaves an existing photo alone unless you set the image URL yourself in the review screen.Re-importing a menu the merchant already has is mostly link and update rows, so this is the usual case when adding photos to a catalog built earlier.

​
Edit items

Click any item to expand its editor. You can change the name, description, price, SKU, cost, supplier, mark up, type, taxes, tag, attributes and image.
  • Turn on Custom price for market-price items. The price field clears and the item is sold at a price entered on the POS.
  • Supplier is created for the merchant if the name is new. Mark up (%) is worked out from cost and price when you leave it blank.
  • Image takes either a web address or a file from your own machine — see below.
  • Sold by weight requires a unit of kg, g, lb or oz, and cannot be combined with custom price.
  • Switching an item to Service reveals duration and booking fields.
Drag the handle on a category to reorder sections. Drag an item between categories to move it. The order you set is the order the merchant sees.

​
Item photos

Paste a web address into Image and Taliup downloads the picture and stores it on Taliup’s own storage — the merchant’s catalog never links to anyone else’s site, so it is unaffected if theirs goes away. Photos are stored at up to 1,200 pixels wide. Some websites refuse to serve pictures to Taliup’s servers even though they load perfectly in your browser. Wix is one. When that happens, click Upload a file instead and choose the picture from your own machine: your browser can fetch what the server cannot, and the file ends up in exactly the same place.
The commit summary counts photos separately from records, and says which ones were downloaded, which you uploaded, which items kept a picture they already had, and which could not be fetched because the hosting site refused Taliup. Photos arrive a minute or so after the commit finishes — reload the product to see them.

​
Fix issues before committing

The banner at the top counts two kinds of problem. Common errors are a missing price on an item that is not custom-priced, an attribute with no values, and a row set to Link existing with no record chosen.

​
Items with no price

A source that gives no price at all — a menu photo where the column was cut off, say — produces a custom price item, which means the cashier types the price at the till on every sale. That is a real decision made on your behalf, so the row carries a warning saying so. Clear it either way:
  • type the price, or
  • confirm the item really is priced at the till, by ticking Custom price on the item or using the Mark as custom price bulk action.
An item whose source says “market price” is custom-priced deliberately and does not warn. A price of 0 is a free item, not a missing one, and does not warn either. Use Only rows with issues to filter the tree down to rows that need attention.

​
Bulk actions

Select items with their checkboxes to reveal the bulk bar: set them all to Link existing or Create new, add a tax, move them to another category, mark them as custom price, or skip them. The overflow menu beside Commit applies Link all confident matches or Create all as new across the whole draft. Mark as custom price is the quick way to accept a whole section that is genuinely priced at the till. It clears each item’s price, turns off Sold by weight, and resolves the missing-price warning on every row it touches.

​
Saving

Edits save automatically a few seconds after you stop typing, and Save draft forces a save. The indicator beside the button shows the current state.
If someone else saves the same draft while you have it open — another admin, or your AI assistant staging an update — you will be told the draft changed elsewhere and asked to reload. Reloading discards your unsaved edits, so save early.

​
Commit

When the error count is zero and everything is saved, click Commit to catalog. A confirmation lists exactly how many records will be created, linked, updated and skipped.
Commit confirmation dialog with a table of Catalogs, Categories, Items, Attributes, Taxes and Tags against Create, Link, Update and Skip columns

The commit confirmation showing a per-record-type breakdown of creates, links, updates and skips.

If the draft updates a catalog that is already assigned to POS terminals, the confirmation names the catalog and the number of terminals, and you must tick a box to continue. Those devices pick up the change as soon as it is committed. To avoid that, leave the catalog row set to Create new so the build lands in a fresh catalog.
Records are written in the background. When it finishes you get a summary of what was created, linked, updated and skipped. Item photos are listed separately, because they are fetched after the records are written. The summary says how many are being downloaded, how many items already had a picture and kept it, how many were dropped because the row was set to Link existing, and how many carried an address that could not be used. Reload a product a minute later to see its photo.

​
If some rows fail

The build returns to Ready for review with the failures listed against the rows that caused them. Fix those rows and commit again — rows that already succeeded are skipped, so nothing is duplicated.

​
Recent builds

The list on the Catalog Builder page shows the last 25 builds for the merchant with status, source, who started it, and counts. Open any build to see its draft or its commit summary. Builds still in progress refresh on their own. Cancel a build you no longer want from the list. Cancelling discards the draft.
Finished builds keep their draft for 7 days and are then cleared, and the uploaded spreadsheet is deleted as soon as the build commits. A build left in review for 30 days is cancelled automatically.

​
One-time setup

This section is for whoever deploys Taliup HQ. Admins using the feature do not need it.
Catalog Builder itself works as soon as the release is deployed and migrations have run. The AI connector is off by default and needs three things.
1

Run migrations

php artisan migrate creates the build tracking table and the OAuth tables used by the connector.
2

Generate OAuth keys

php artisan passport:keys on each environment. The keys are not kept in source control.
3

Enable the connector

Set CATALOG_BUILDER_MCP_ENABLED to true, and list the AI clients allowed to connect in MCP_REDIRECT_DOMAINS. Leaving the flag off hides the connector card and disables its endpoints.
To let the connector read a merchant’s menu from their website, list the domains it may fetch in MENU_FETCH_ALLOWED_DOMAINS, comma separated. The list is empty by default, which switches the feature off. A domain covers its subdomains, so example.com also permits www.example.com and order.example.com.
Never allowlist a delivery marketplace such as Uber Eats, DoorDash or SkipTheDishes. Their listed prices include commission and are simply the wrong prices for a POS catalog, quite apart from their terms of use.
Imported item photos are stored no wider than 1,200 pixels (CATALOG_BUILDER_IMAGE_MAX_WIDTH), and a photo uploaded in the review screen may be up to 10 MB (CATALOG_BUILDER_IMAGE_UPLOAD_MAX_MB). Background work — including fetching item photos — runs on a dedicated catalog-builder queue, so the queue worker must include it:
Give Catalog Builder its own worker rather than relying on the default queue. Where several sites share one database, every one of their workers polls default, and a deployment that does not have this release’s job classes will pick a job up and fail it immediately. Nothing appears in this application’s log, because nothing in this application ran — look in failed_jobs, where the stack trace names the site that took it.
A scheduled task, catalog-builder:prune, clears old drafts, expires abandoned reviews, and removes photos uploaded during review that were never committed. It runs daily as part of the normal scheduler.

​
When photos do not arrive

Photos are fetched after the records are written, so several separate things can stop one without stopping the build. Two read-only scripts in the application root answer it in order, rather than by guesswork:
Reports whether the deployed code is current, what the last commit’s photo counts were, what the draft rows look like, whether the jobs were queued or failed, and how many media rows landed.
Walks one photo through every step the job takes — environment, product lookup, download, resize — and prints each outcome.
Fetches several hosts with several header sets, so a site that refuses this server is distinguishable from a server that cannot reach the internet.
A photo that cannot be downloaded leaves a failed job and a warning in the log naming the URL and the reason. It is not silent.