TroveCart Documentation

RocketCart transforms your Shopify store's cart into an intelligent upselling machine. Here's how to get up and running.

Installing the App

1. Visit the RocketCart listing on the Shopify App Store and click Install.
2. Authorize the app to access your store's products, orders, and theme data.
3. You'll be redirected to the RocketCart onboarding screen inside your Shopify admin.

Onboarding Steps

1. Choose a Plan — Select the plan that fits your store. All plans come with a 7-day free trial.
2. Enable the App Embed — Go to your Shopify theme editor, find RocketCart under App Embeds, and toggle it on. This loads the cart drawer on your storefront.
3. Sync Products — Click "Sync Products" on the dashboard to import your product catalog. This is required for AI recommendations.

Important: The app embed must be enabled in your Shopify theme editor for the cart drawer to appear on your store. Go to Online Store → Themes → Customize → App Embeds and enable RocketCart.

The dashboard is your home base for monitoring RocketCart's performance.

Setup Guide

A three-step checklist at the top of the dashboard shows your progress:

• Choose a plan — shows your subscription status
• Enable app embed — links directly to the theme editor
• Sync products — imports your catalog for recommendations

Today's Stats

Four metric cards show real-time data for the current day:

• Add to Carts — how many products were added via the drawer
• Revenue — total revenue attributed to recommendations
• Impressions — total widget views
• Click-through Rate — percentage of impressions that led to clicks

Last 7 Days

The same metrics with sparkline charts showing the trend over the past week.

Quick Actions

Buttons that link to Configure Widgets, View Analytics, and Settings.

The widget configuration page is where you customize every aspect of your cart drawer. It uses a three-panel layout:

• Left Sidebar — Navigation tree listing all widgets grouped by section (Design, Header, Body, Footer, Localization). Each widget shows an On/Off status badge.
• Middle Panel — The settings form for the currently selected widget.
• Right Panel — A live preview of the cart drawer that updates as you change settings.

Click any widget in the sidebar to load its settings. Changes are saved when you click the Save button.

Templates are pre-designed color schemes you can apply with one click. They set colors for the drawer and all widgets at once.

Available Templates

• Minimal Light — White background, soft corners, subtle green accents. Best for clean, modern stores.
• Bold Dark — Dark gray background, sharp edges, teal accents. Best for fashion, tech, gaming stores.
• Warm & Friendly — Cream background, soft corners, coral accents. Best for lifestyle, beauty, food stores.

Tip: After applying a template, you can still customize individual widget colors. The template is just a starting point.

You can reorder widgets within the Header and Body sections by dragging and dropping them in the sidebar navigation. Footer widgets have a fixed order.

Default Order

• Header: Announcement Bar → Free Shipping Bar
• Body: Still Interested → Recently Viewed → AI Recommendations → Order Notes
• Footer: Gift Wrapping, Shipping Protection, Discount Code, Checkout, Trust Badges (fixed)

The cart drawer is the main container that slides in from the right side of the page when a customer interacts with their cart.

Enable / Disable

Toggle the drawer on or off. When disabled, your theme's default cart behavior is used.

Open on Add to Cart

When enabled, the drawer automatically slides open whenever a customer adds a product to their cart. This gives immediate feedback and shows upsell opportunities.

Text Customization

• Cart title — the heading shown at the top of the drawer (default: "Your Cart")
• Empty cart message — shown when the cart is empty
• Continue shopping text — the button to close the drawer
• Checkout button text — the main checkout button label

Appearance

• Drawer width — choose from 300px, 350px, 400px, 450px, or 500px
• Border radius — slider from 0 to 24px for rounded corners
• Background color — the drawer's background
• Header background — separate color for the header area
• Text color — body text throughout the drawer
• Primary color — buttons and accent elements
• Button text color — text on buttons

Control how products in the cart are displayed:

• Show product images — toggle thumbnail images
• Show quantity selector — +/- buttons for adjusting quantity
• Show remove button — allow removing items from cart
• Show item prices — individual product prices
• Show product ratings — star ratings if available

Subtotal & Footer

• Show subtotal — display the cart total
• Subtotal label — customizable label (default: "Subtotal")
• Taxes note — "Taxes and shipping calculated at checkout" message
• View cart button — optional link to the full cart page

A banner at the top of the cart drawer for promotions, urgency messaging, or store announcements.

Display Modes

• Normal — show a static or rotating text message with an optional link
• Cart Reservation — a countdown timer that creates urgency (e.g., "Your items are reserved for 15:00 minutes")

Display Styles

• Rotating — cycles through multiple messages automatically at a set interval
• Running Line (Marquee) — continuously scrolls the message across the bar

Cart Reservation Settings

When Cart Reservation is selected:

• Timer duration — how long the reservation countdown runs
• Expired action — what happens when the timer ends: hide countdown, hide the entire bar, or show a custom expired message
• Timer color — color of the countdown text

Colors

• Background color (solid or gradient with start/end colors)
• Text color

Motivate customers to add more to their cart by showing progress toward a free shipping threshold.

Settings

• Threshold — the cart value needed for free shipping (e.g., $50)
• Progress message — shown while below threshold. Use {remaining} to insert the amount needed (e.g., "You're $15.00 away from free shipping!")
• Achieved message — shown when the threshold is reached (e.g., "You've unlocked free shipping!")
• Icon — choose from truck, box, gift, rocket, star, or none
• Show on product page — also display the bar on product detail pages

Colors

• Bar color — the filled portion of the progress bar
• Bar background — the unfilled portion
• Text color — the message text

Shows products the customer has browsed during their session, encouraging them to revisit and purchase.

Display Settings

• Max products — 1 to 6 products (default: 4)
• Card width — 40% to 100% of the container
• Show product images, prices, sale badges
• Show view count — displays "Viewed 3x" badges

Templates

• Carousel — horizontal scrollable row with arrows
• Card — box-style layout with shadows
• Minimal — simple list with minimal styling

Animation

• Slide, Fade, or None
• Auto-scroll — automatically advance through products in carousel mode

Colors

Toggle Use drawer colors to inherit the drawer's primary and text colors, or set custom colors for this widget.

RocketCart uses AI to suggest complementary products based on the customer's cart contents and your product catalog.

Generating Recommendations

1. Make sure your products are synced (Dashboard → Sync Products).
2. Go to Widget Configuration → AI Recommendations.
3. Click Generate Recommendations. A progress bar shows the status.

Recommendations are pre-computed for fast performance and regenerated automatically when products are updated.

How it works: RocketCart analyzes your product titles, descriptions, tags, and order history to find relationships between products. For single-item carts, pre-computed recommendations load in under 10ms. For multi-item carts, real-time AI analysis finds the best cross-sell opportunities.

Display Settings

Same options as Recently Viewed: template (carousel/card/minimal), max products (1-6), card width, animation, auto-scroll, and color customization.

Customization

• Heading — e.g., "You may also like" (default)
• Button text — the add-to-cart button label
• Show product images, prices, sale badges

This widget detects when a customer has viewed a product multiple times without buying and offers them a personalized discount to convert.

How It Works

1. The customer views a product page (tracked per session).
2. After reaching the minimum view threshold, the widget appears in the cart drawer.
3. A unique discount code is generated with a countdown timer.
4. The customer can apply the discount and add the product in one click.

Discount Settings

• Enable discounts — toggle automatic discount code generation
• Base discount — percentage off (1-25%, default: 5%)
• Max discount cap — upper limit (5-30%, default: 10%)
• Duration — how long the code is valid (1-72 hours, default: 24)
• Combine with other discounts — allow stacking with existing discount codes

Display Rules

• Minimum views to trigger — how many times a product must be viewed (1-10, default: 2)
• Cooldown days — days to wait before showing again after dismissal (1-14, default: 3)
• Max discounts per week — limits per visitor (1-10, default: 2)
• Show countdown timer — display the discount expiration countdown

Custom Texts

All text supports placeholders:

• Headline — e.g., "Still interested in {product}?"
• Subtext — e.g., "Here's a special discount just for you"
• Button text — e.g., "Apply & Add to Cart"
• Discount badge — e.g., "{percent}% OFF"
• Timer text — e.g., "Expires in {time}"

Allow customers to add special instructions to their order directly from the cart drawer.

• Show order notes — toggle the text area on or off
• Label — the heading above the field (e.g., "Order Notes")
• Placeholder — hint text inside the field (e.g., "Add special instructions...")

Offer gift wrapping as an add-on service directly in the cart drawer.

Basic Settings

• Price — the gift wrap fee (default: $4.99)
• Label — display text (e.g., "Add Gift Wrapping")
• Description — a short description of the service
• Icon — choose from gift, ribbon, box, or heart
• Product image — optional custom image URL

Gift Message Form

When enabled, customers can fill in:

• From field
• To field
• Personal message textarea

Colors

Toggle Use drawer colors or set custom background, primary, text, and body text colors.

Offer shipping protection insurance as an add-on in the cart drawer.

• Price — the protection fee (default: $2.99)
• Label — display text (e.g., "Add Shipping Protection")
• Description — describes what the protection covers
• Product image — optional custom image
• Colors — same options as Gift Wrapping

Let customers apply discount codes directly in the cart drawer without leaving the page.

• Label — section header (default: "DISCOUNT")
• Placeholder — input hint (default: "Discount code")
• Button text — apply button label (default: "Apply")

Applied discounts show with a remove button. Invalid codes display an error message.

The checkout area at the bottom of the cart drawer contains:

• Subtotal display — with customizable label
• Taxes note — "Taxes and shipping calculated at checkout"
• Checkout button — directs to Shopify checkout (includes any applied discount codes)
• Continue shopping button — closes the drawer
• View cart button — optional link to the full cart page

Display payment method and security icons to boost checkout confidence.

Available Badges

Choose from 40+ icons including:

• Credit cards — Visa, Mastercard, Amex, Discover, JCB, Maestro, Diners Club
• Digital wallets — Apple Pay, Google Pay, Shop Pay, Amazon Pay, PayPal
• Buy now, pay later — Klarna, Afterpay
• Regional methods — Alipay, iDEAL, PIX, Mercado Pago, UPI, Paytm, and more
• Crypto — Bitcoin, Ethereum, Litecoin

Icon Size

Choose Small, Medium, or Large.

RocketCart supports multiple languages so you can serve international customers.

Adding a Language

1. Go to Widget Configuration → Translations.
2. Use the "Add new language" dropdown to select a language.
3. Fill in translations for each widget section (drawer, free shipping, recommendations, etc.).
4. Click Save.

Supported Languages

French, German, Spanish, Italian, Portuguese, Dutch, Japanese, Chinese (Simplified & Traditional), Korean, Arabic, Russian, Polish, Swedish, Norwegian, Danish, and Finnish.

Auto-Detection

RocketCart detects the customer's locale from the store settings and displays translated text automatically. If a translation is missing for a field, the English default is used.

What Can Be Translated

All user-facing text in every widget: headings, button labels, messages, placeholder text, descriptions, and notes.

Track how your cart widgets perform and measure their impact on revenue.

Time Range

Select from: Today, Yesterday, Last 7 Days, Last 30 Days, This Month, or Last Month.

Performance Metrics

• Impressions — Number of times widgets were shown to customers
• Clicks — Product clicks from recommendation widgets
• Add to Carts — Products added to cart from widgets
• Click-through Rate — Percentage of impressions that resulted in clicks
• Add-to-Cart Rate — Percentage of impressions that resulted in cart adds
• Conversion Rate — Overall conversion from impressions to revenue

Revenue Attribution

RocketCart tracks which recommendations led to purchases within a 24-hour window:

• Attributed Revenue — total revenue from recommended products
• Attributed Orders — number of orders containing recommended items
• Average Order Value — average value of attributed orders

Revenue by Widget

A table breaking down each widget's impressions, clicks, CTR, add-to-carts, revenue, and orders.

Activity Over Time

Line charts showing trends for impressions, clicks, add-to-carts, revenue, and orders over the selected period.

Top Products

See which recommended products perform best by impressions and conversions.

CSV Export

Click the export button to download your analytics data as a CSV file.

Plans

• Starter ($29.99/mo) — 500 orders/month, unlimited products, basic analytics, community support, 7-day free trial
• Growth ($79.99/mo) — 2,000 orders/month, unlimited products, advanced analytics, community support, 7-day free trial
• Pro ($199.99/mo) — Unlimited orders, unlimited products, advanced analytics, priority email support, 7-day free trial

Free Trial

All plans come with a 7-day free trial. You won't be charged until the trial ends. Cancel anytime during the trial to avoid charges.

Changing Plans

Go to the Subscription page, select a new plan, and confirm the change. Plan changes take effect immediately. The billing difference is prorated.

Cancellation

You can cancel your subscription from the Subscription page. Your features remain active until the end of the current billing period.

Usage Tracking

The subscription page shows a progress bar with your current order count versus your plan's limit for the current billing period.

Get support directly from within the RocketCart dashboard.

Creating a Ticket

1. Go to the Help Center page.
2. Click New Ticket.
3. Enter a subject, describe your issue, and set a priority (Low, Normal, or High).
4. Click Submit.

Viewing & Replying

All your tickets appear in a list. Click a ticket to see the full conversation. You can reply to any open ticket.

Editing Window

You have a 5-minute window after creating a ticket to edit the subject or description. After 5 minutes, the ticket is locked for editing but you can still add replies.

Tip: Support replies are color-coded — green for support team responses and gray for your messages.

The cart drawer isn't showing on my store

Make sure the app embed is enabled. Go to Online Store → Themes → Customize → App Embeds and toggle RocketCart on. If it's already enabled, check that the drawer is turned on in Widget Configuration → Drawer Settings.

AI Recommendations aren't generating

You need to sync your products first. Go to the Dashboard and click Sync Products. Once syncing is complete, go to AI Recommendations and click Generate Recommendations.

How do I change the drawer colors?

Go to Widget Configuration → Drawer Settings and use the color pickers for background, header, primary, and text colors. Or apply a Template for a quick preset.

How do I reorder widgets?

In the Widget Configuration sidebar, drag and drop header or body widgets to change their order. Footer widgets have a fixed position.

My discount code isn't working in the drawer

Make sure the discount code exists in your Shopify admin (Discounts section) and is active. The code must match exactly, and the cart must meet any minimum requirements set on the discount.

Still Interested widget not appearing

The widget only shows after a customer views the same product the required number of times (default: 2). Check the Minimum views to trigger setting. Also check the Cooldown days setting — if the customer recently dismissed the offer, it won't show again until the cooldown expires.

How do I add a new language?

Go to Widget Configuration → Translations, select a language from the "Add new language" dropdown, fill in the translations, and save.

Can I use RocketCart with my existing cart page?

Yes. RocketCart works as a slide-out drawer alongside your existing cart page. The "View Cart" button in the drawer links to your store's default cart page. You can also disable the drawer entirely if you only want the analytics features.

Does RocketCart slow down my store?

No. The cart drawer loads asynchronously and doesn't block your page from rendering. The JavaScript is lightweight and only activates when a customer interacts with the cart.

How is revenue attributed?

RocketCart tracks which products were shown as recommendations and links them to orders placed within 24 hours. If a recommended product appears in an order, the revenue is attributed to RocketCart.