Docs
The shop portal
- Signing in
- Usage and billing
- Inventory
- Spreadsheets: download, template, import
- Refreshing from your store
- What you sell
- Records
- Reverb
- Storefront embed
- Reports and conversations
- The staff tools
- Cancelling and your data
1. Signing in
There is no password. Enter the email address you registered with, and we send a sign-in link that works once and expires in 30 minutes. Click it and you're in for 30 days on that browser; Log out at the top of the page ends it sooner.
2. Usage and billing
The top card shows each product you hold: how much of this cycle's allowance you've used, when it resets, and the plan's tier.
- Allowances. A listings plan counts C.H.A.D. readsreads plan counts Vinyl Intake reads; a chats plan counts concierge messages. The count starts over on your billing day, the day of the month your billing began, which the card names along with the next reset date. Nothing carries over and nothing is prorated. When an allowance is used up the tool pauses until the next cycle or until you move up a tier.
- Brady. The storefront plan has no allowance: it's on while you hold it. Without it, a paying gear shop's public storefront and embeds show a short "not active" notice.
- The records storefront is included with any vinyl plan; there's nothing to count.
- Adding a plan. For a product you don't hold yet, the card offers the tiers. During beta we set up plans and payment details with you personally, so if you don't see a button, email us and we'll sort it the same day.
- Changing or cancelling. Manage billing opens your Stripe billing page: move up or down a tier, update a card, see invoices, or cancel. A cancellation takes effect at the end of the current cycle.
- Bonus credits. If we've granted you credits, they're drawn on after the plan allowance and never expire.
3. Inventory
Everything the concierge recommends and the storefront shows comes from this list. There are four ways to fill it, and they mix freely:
- By hand. Add item opens the form: title, make, model, year, finish, category, condition, price, description, photo, and the address of the item's page on your own site if it has one. Leave the price empty to show "call for price". Untick In stock to hide an item without deleting it.
- From a spreadsheet. See the next section.
- From C.H.A.D.Vinyl Intake. Every listing staff publish from the photo tool lands here.
- From your store. If your stock lives on your website, a refresh pulls it in. See section 5.
Items that came from your store are marked as synced: edits you make to them by hand are overwritten at the next refresh, so make those edits on your store instead. The Makes in stock tile is a quick count of brands currently in stock.
4. Spreadsheets: download, template, import
The spreadsheet card sits above the inventory list, and a second one above the records list. Three downloads and one upload, all CSV files that open in Excel, Numbers or Google Sheets:
- Download from website. If we could read your store's product feed (WooCommerce, Shopify and Squarespace stores expose one), this gives you what's on it, already laid out in our columns, so onboarding is "download, tidy, upload".
- Download what we hold. Your current inventory here, in the same columns. Handy for bulk price changes or a backup.
- Download a blank template. The columns with one example row.
- Upload. Choose your file and the portal shows a preview first: how many rows will be added, how many updated, and any rows with problems and why. Nothing is written until you click Import. Rows are matched by SKU, so uploading the same file twice updates rather than duplicates.
The columns are described on the template's first row. The essentials are title, category and price; everything else improves what the concierge can say about an item.
5. Refreshing from your store
Each shop has a source of truth for its stock, set when we onboard you: this portal, or your WooCommerce, Shopify or Squarespace store.
- When the source is your store, Refresh inventory reads the store's public product feed, updates matching items here, and marks anything that has disappeared from the feed as out of stock. A shop connected to Reverb is refreshed from Reverb the same way. Refreshes are rate-limited to a few per hour; the status line tells you when the next one is allowed and when the last one ran.
- When the source is us, there is nothing to refresh and the button says so: add items by hand, upload a spreadsheet, or let the photo tool draft them.
The store connection is one-way today. bogz.io reads from your WooCommerce, Shopify or Squarespace store to bring your catalogue in — it never writes anything back to your store. The only place bogz.io writes listings out to is Reverb, and only as drafts you publish yourself. Two-way sync — writing changes back to your store — is coming in a later release. So today the flow is your store → bogz.io → Reverb.
6. What you sell
Two switches: instruments and gear, and vinyl records. Turning records on adds a records section to the portal, unlocks Vinyl Intake (the photo tool for records, same staff key), and gives you Vinnie, a second concierge just for the bins; embed him next to Brenner with data-concierge="vinnie", or use vinnie.js. Turning a type off hides its section; nothing is deleted.
7. Records
Your vinyl, graded Goldmine-style with media and sleeve graded separately. Add record opens the full form: artist, title, label, catalogue number, pressing year and first-release year, genre and style, format, pressing details, colour, country, the tracklist one line per track, the matrix and runout one side per line exactly as etched, barcode, bin location for staff, price, grades, condition notes shoppers see, cover photo, and optional Discogs ids. Records come in the same four ways as gear: by hand, by spreadsheet, from Vinyl Intake, or from your store's feed.
Tick "still factory sealed" and the sleeve is graded while the media is not. The records storefront and grid show whatever is marked in stock.
68. Reverb
Connect your own Reverb account and the photo tool can push finished listings straight into your Reverb dashboard as drafts. Publishing is always your click, inside Reverb.
- In Reverb, open My Profile → API & Integrations → Generate New Token, with the
public,read_profile,read_listingsandwrite_listingsscopes. - Paste the token into the Reverb card and click Connect. We check it with Reverb before saving it, and store it encrypted.
- Disconnect at any time from the same card. Existing drafts on Reverb are unaffected.
79. Storefront embed
The grid you embed on your own site ships as a clean photo grid: search and filters are off so shoppers ask your concierge instead. The switch here turns the toolbar on for the embed. The hosted storefront at guitarz.ai/store/yourshop always shows it. Everything else about the grid is set on the tag itself; see the embed docs.
When your stock comes from WooCommerce, a second switch turns on Add to cart: shoppers fill a cart on the grid and your hosted storefront, then check out on your own WooCommerce site, where payment, shipping and the order stay. See Add to cart in the embed docs.
Questions about the concierge itself. If a shopper asks your concierge what it is or who made it, it answers in a sentence or two from what we keep about guitarz.aivinylz.ai (the company, where a shop owner signs up) and steers back to your shop. It never brings it up on its own and never pitches it, and anything about your shop (stock, prices, hours, policies) still comes only from your shop facts and inventory.
810. Reports and conversations
The Activity tab is what your concierge has been doing. Pick the period at the top: the last 7, 30 or 90 days, this month, last month, or any dates with From / To and Apply. Days run midnight to midnight on your shop's clock. The line under the picker totals the period (shopper messages, catalog searches, item clicks and click-through rate), and everything below follows it. The tiles at the top of the portal always show the last 30 days.
- Activity by hour of day: when shoppers chat and what the concierge searched for, hour by hour on your shop's clock. The hours follow the time zone on the Setup tab, daylight saving included; it starts as your browser's zone when you sign up, and you can change it there any time.
- What shoppers are asking about: keywords pulled from their messages.
- Brand interest: what shoppers searched for against what they actually clicked through to. These differ more often than you'd think.
- Most-clicked items.
- Conversations: every chat in full, newest first, so you can read exactly what was asked and answered. This list has its own search and sort, and isn't limited by the period.
Conversations, searches and clicks are kept for 180 days and then deleted, so a period that reaches further back shows only what's left. Ask us if you want a shorter window.
911. The staff tools
C.H.A.D. opens from the mascot on your site, or directly at guitarz.ai/chad.Vinyl Intake opens at vinylz.ai/records. Staff sign in inside the tool with your shop's staff key (sk_…). You create and manage it yourself in the portal — generate one, share it with your staff, and regenerate it any time to cut off an old key (that instantly invalidates the previous one). It's a private credential: don't put it in a public page or a shared document. Your widget key (pk_…) is the public one that goes in the embed tags; both are in your setup email, and we'll resend them any time.
What C.H.A.D. can identify
Instruments, and the rest of the shop floor: amplifiers (combos, heads, cabinets, modelers), effects pedals, pro audio (mics, interfaces, mixers, PA, monitors), string sets (filed under Strings) and other accessories (capos, straps, cases), usually read off the packaging and its barcode, parts (pickups, tuners, tubes, speakers), keyboards, drums, and band & orchestra instruments (brass, woodwinds, violins, harmonicas). Each is filed under the matching category, so it shows in the right place on your storefront, Brenner can recommend it, and the Reverb draft lands in the right category too.
Photos. Pick the type chip (amplifier, pedal, pro audio, accessories, parts, keyboards, drums, band & orchestra) so the tool knows what it's looking at, then shoot what it reads from. The first five photos are the ones it reads.
- Amps: the full front, the control panel, and the rear panel or serial plate. That plate is where the model code, serial, country and any wattage come from. An open back, or the speaker through the grille, helps with the speaker and the tubes.
- Pedals: the top face square-on, and the bottom plate: power spec, serial or date code, "Made in", and whether there's velcro on it (noted as wear, not hidden).
- Everything else: the front, the rear or connector panel, and the label plate. Accessories: the packaging front and back, barcode included. Parts: the part on a plain background plus any stamp or label.
What it will and won't claim.
- Numbers come off a label or not at all. Wattage, power requirements and channel counts are transcribed from the rear panel, bottom plate or badge, never filled in from memory however well known the model; a number that wasn't read is simply left out of the title and the specs. Wattage always carries a confirm badge in the review form, so check it: a rear plate often prints the mains power consumption (say 180W) rather than the amp's output, and the number you confirm goes in the title.
- It never says something works. "Powers on, tested" is your staff note, and the copy only says it when you've written it there. What the photos show, such as tolex tears, a dented enclosure, velcro on the bottom or a missing knob, is listed as wear for you to grade from.
- Overdrive, distortion or fuzz follows the product family as the maker names it (a Tube Screamer is an overdrive, a RAT a distortion, a Big Muff a fuzz), never a judgement of how it sounds. A generic name ("Drive") comes back with alternatives to pick from.
- Always yours to confirm: vintage versus reissue on Fender, Marshall and Vox amps (a '65 Deluxe Reverb Reissue is not a 1965 Deluxe Reverb), and the exact revision of a collectible pedal (TS808 or TS9, a Ram's Head Big Muff, a Boss black label). The tool offers these as candidates unless a label or serial backs them up, and the title names a revision only once you've confirmed it.
The review form. Gear fields (format, technology, wattage, speaker configuration, channels, effect type, power, enclosure and so on) appear only on drafts that have them, as dropdowns of the values the platform knows, with the AI's pick and its alternatives first and "type my own" last. Changing the instrument type redraws the form for that type and moves the listing to the right category. Features (read off the panel) lists what it saw on the labels (reverb, effects loop, tap tempo, MIDI); if one is wrong, say so in the staff notes. Also does lists a two-in-one pedal's other effects. The copy and the Reverb category then follow what you confirmed: the title leads with the spec buyers search on (wattage and format for an amp, the effect type for a pedal, key count for a keyboard); amps get their Reverb subcategory automatically, pedals and pro audio get theirs from Reverb's own category list when the draft is pushed, and accessories, parts, keyboards and drums go to their Reverb root. You can still refine the category inside Reverb's draft editor.
It doesn't cost extra. A listing counts against your allowance once, when the photos are read, whatever the item turns out to be.
How C.H.A.D. writes the copy for current models
When staff click Generate listing copy on an instrument that's still in production — a Brand New condition grade, or a year within the last five — C.H.A.D. first finds the model on the maker's own website and hands the copywriter the manufacturer's description, the feature names they use and their spec sheet. The listing then reads in the maker's vocabulary, with the specs as the maker prints them, instead of generic filler.
- Only the maker's site. The search and the page it reads are restricted to the manufacturer's own website; a retailer, marketplace, forum or review is never used. A page that isn't this exact model and trim is ignored rather than risk the wrong specs on your listing.
- Your reviewed fields still win. Finish, condition, modifications, included items and price come only from what staff reviewed. Anything on the maker's page that contradicts them is left out, and the maker's price is ignored.
- Older and vintage gear is written from the reviewed fields alone, as before. The year staff enter decides ("mid 80s" counts as old), and without a year only a Brand New grade triggers the lookup. Pedals are the exception: a pedal with no year is looked up anyway, since most pedals on a used shelf are still in production, unless a known year says it's older than five years.
- You can see the source. When a maker's page was used, the copy card says so under the description — "Wording and specs drawn from the maker's page for model", with a link to the site — so staff can check it. The copy is editable before it's saved or pushed anywhere.
- It doesn't cost a read. A listing counts against your allowance once, when the photos are read. The lookup starts in the background right after that, and the result is kept for 30 days for every shop that lists the same model, so Generate listing copy usually finds the page already waiting. When it does have to look the page up on the spot, expect 30–50 seconds.
1012. Cancelling and your data
- Cancel subscription at the top of the page ends your plans at the end of the current cycle. The portal and your data stay until you ask us to delete the shop.
- Your data is yours. Download it as a spreadsheet at any time. On request we delete the shop and everything under it, except billing records the law makes us keep.
- Questions. support@guitarz.ai, from the address on your registration so we can verify you.