CataBoost Help Center

How to Connect Your Products

You have several ways to get your products into the platform:

• Feed URL – Enter a product feed URL for a catalog you own or are authorized to use, and we'll import your products automatically
• Upload a File – Drag and drop a CSV, XML, or spreadsheet file with your product data
• Connect Shopify – Click "Connect Shopify" and follow the authentication steps. Products sync automatically!
• Connect WooCommerce – Import products from your WooCommerce store
• Connect Meta Catalog – Import from Facebook/Instagram product catalogs
• Connect Google Merchant Center – Import products from your existing Google catalog
• Connect TikTok – Import from your TikTok product catalog

Managing Products

• Search – Find specific products by name, SKU, or other attributes using the search bar
• Filter – Filter by availability, category, brand, price range, or other attributes
• Sync – Click the sync button to refresh products from the connected source
• Auto-Sync – Set up automatic syncing on a schedule so your products stay up-to-date without manual work
• Exclude Out-of-Stock – Option to automatically exclude products that are out of stock
• Manage Fields – Customize which product fields are imported and how they're mapped

Example Use Cases

• "Sale Items" – All products currently on sale
• "New Arrivals" – Products added in the last 30 days
• "Best Sellers" – Your top-performing products
• "Under $50" – Budget-friendly products for specific ad campaigns
• "Holiday Collection" – Seasonal products for themed ads

Video Mode

Switch the builder into Video Mode to animate your layers and export short product videos right from your design — no separate tool needed.

Getting Started

1. Choose a template or start from scratch — you can also import a PSD or Figma design
2. Select a product to preview your design with real product data
3. Add and customize elements — text, images, shapes, product image, and more
4. Save and publish your design to use in output feeds

What You Can Add

• Text Layers – Add product names, prices, sale info, or custom text with full font control
• Images – Add logos, badges, overlays, backgrounds, or decorative elements
• Shapes – Rectangles, circles, and other geometric shapes with fill, stroke, and opacity
• Product Image – Automatically pulls the product image from your feed

Dynamic Elements

Link any layer to your product feed so content updates automatically for each product. When your feed generates, each product gets its own unique creative!

Common dynamic fields include:

You can also map to any custom column from your product feed! Set a fallback field or static fallback value for products missing that data.

Layer Controls

• Move & Resize – Click and drag elements to position and resize them
• Layer Order – Use the layers panel to arrange which elements appear in front or behind
• Lock/Unlock – Lock layers you don't want to accidentally move
• Hide/Show – Toggle visibility while designing without deleting
• Duplicate – Copy a layer to quickly reuse it
• Delete – Remove unwanted elements

AI Features

• Generate Image – Describe what you want and AI creates it for your design
• Generate Ad Copy – Get AI-suggested text for your ads based on product data

AI features are available on Business and Agency plans.

Saving Your Work

• Save Design – Save your current design to edit later
• Save as Template – Create a reusable template for future products
• Publish – Make your design available for use in Output Feeds

Importing Designs

You can import existing designs to save time:

• PSD Import – Upload a Photoshop file and we'll convert the layers into editable elements
• Figma Import – Paste a Figma URL to import your design directly
• Dynamic fields are auto-matched based on layer names (e.g., a layer named "price" will be mapped to product price)

How It Works

1. Create an AI Image Field: Set up a custom field to store your AI-generated images.
2. Write a Prompt: Use our prompt editor to describe the scene, or choose from our extensive library of presets (e.g., Studio, Minimal, Lifestyle, Surreal).
3. Select a Model: Choose between "Boost Vision" (Fast, great for previews) and "Boost Vision Pro" (Recommended, highest quality).
4. Generate: Generate previews for a few products to test your prompt, then process your entire product feed.

Using Generated Images

Once generated, your AI images are saved to the AI Image field you created. You can use these images in two ways:

• Include in Feeds: Map the AI Image field directly to your output feeds as the main or additional image.
• Use in Designs: In the Creative Builder, link an image layer to your new AI Image field to create dynamic ad templates.

Creating a New Design

1. Click "New Design" — choose between Static Image or Video
2. Select a canvas size from the presets or enter custom dimensions
3. You'll be taken to the Creative Builder to design

Size Presets

• Square (1080×1080) – Instagram / Facebook Feed
• Story (1080×1920) – Instagram Stories, Reels, TikTok
• Portrait 4:5 (1080×1350) – Facebook / Instagram Feed Ads
• Pinterest Pin (1000×1500) – Tall pin format
• Wide Banner (1200×600) – Google Display / Website
• Custom – Enter any width and height

Managing Designs

• Search – Find designs by name
• Filter – View only static or video designs
• Edit – Click on a design to re-open it in the Creative Builder
• Delete – Remove designs you no longer need

How It Works

1. Select products – Choose which products to feature (or use a Product Set)
2. Pick a design – Select a saved design as your video template
3. Choose transitions – Pick how slides change between products (fade, slide, zoom, wipe, and more)
4. Add music – Upload your own audio or use stock music
5. Generate – Click generate and download your video!

Video Settings

• Duration per Product – How long each product appears (1–10 seconds)
• Transitions – Fade, slide, zoom, wipe, and many more animation styles
• Product Limit – Videos support up to 50 products. Create a Product Set of 50 items or fewer for best results

Video Formats

• Vertical (9:16) – Instagram Reels, TikTok, YouTube Shorts
• Square (1:1) – Instagram Feed, Facebook
• Landscape (16:9) – YouTube, TV ads
• Custom sizes are also available for specific platform needs

Adding Audio

• Upload – Add your own music or sound effects (MP3, WAV)
• Stock Audio – Browse the library of free-to-use tracks
• No Audio – Leave it silent if you prefer

Creating an Output Feed

1. Click "Create Output Feed"
2. Name – Give your feed a descriptive name (e.g., "Holiday Campaign - Sale Items")
3. Platform – Choose your target platform: Meta, Google Ads, Pinterest, or TikTok
4. Feed Format – Choose "Supplemental Feed" (the default and recommended if your products are already on the platform — it adds your designs on top of the existing catalog without touching titles, prices, or links) or "Main Feed" (a complete catalog with all product data plus your designs — use it when the platform doesn't have your products yet)
5. Save Design As – Main Image replaces the product photo so ads show your design automatically (image_link); Additional Image keeps the original photo and adds your design as an extra image that you pick in your campaign setup (additional_image_link). On Meta supplemental feeds, Main Image makes your first design the main catalog image (the original photo rides along as an additional image), while Additional Image — the recommended choice — keeps the original photo first and adds designs as tagged additional images. With an API connection, the Campaign Image Manager can push any additional image as the default image for a specific campaign or ad
6. Delivery Method – Choose Download File (manual upload) or Direct API Sync (automated push to platform)
7. Select Designs – Pick which designs to apply to products
8. Product Set (optional) – Apply the feed to a specific product set
9. Click Create!

Delivery Methods

• Download File – Generates a CSV file you can manually upload to your advertising platform
• Direct API Sync – Connects directly to your Meta, Google, Pinterest, or TikTok account and pushes your feed automatically. Requires connecting your ad account. Available on Starter plans and above.

Connecting to Platforms

When using Direct API Sync, connect your ad platform account directly:

Multi-treatment Strategies

When multiple designs are selected, choose how they are applied to products:

• Standard Output – For Main Feed, uses the first design for all items. For Supplemental Feed, adds all designs — as additional images, or with the first design taking the main image slot when Save Design As is Main Image.
• Split Test – Evenly distributes designs across products for A/B testing. Automatically adds a treatment:id label so you can measure performance.
• Conditional Assignment – Assign specific designs to products that match filter rules (e.g., Category equals "Shoes" → use the Shoes design). Unmatched products use the first design as fallback.

Apply Designs To – With Standard Output (or a single design), limit rendering to a saved Product Set or custom conditions — one selection for every design, or Per design so each design has its own Product Set or conditions and a product receives every design it qualifies for. Products outside a selection stay in the feed with their original images and don't consume renders — handy when a design only fits 10% of the catalog.

Manage Feed Fields

Control exactly which fields appear in your output feed:

• Exclude Fields – Remove unwanted columns from your feed (e.g., internal IDs)
• Rename Fields – Change column names to match your platform's requirements
• Preview – See sample values from your products for each field

Access via the ⚙️ gear icon on each feed row, or the "Manage Fields" button in the create/edit modal.

Variant Availability Filter

Automatically handle products with low variant availability:

• Set a minimum in-stock threshold (e.g., 50%) — products with fewer in-stock sizes/variants are filtered
• Exclude – Completely remove those products from the feed
• Label – Keep them in the feed but add a custom label (e.g., low_variant_availability) for platform-side filtering

Products are grouped by item_group_id to evaluate variant availability across sizes.

Optional attribute rules let you compute availability over specific attributes (e.g., only Size) for products in a chosen product set. When attribute rules are configured, the filter only applies to product groups matching a rule's product set — everything else is left untouched.

Feed Actions

Each feed in the table has these action buttons:

• Regenerate – Rebuild the feed with the latest product data and designs
• Pre-render Images – Warm the image cache by pre-generating all product creatives. This speeds up feed delivery so advertising platforms see images instantly instead of waiting for on-demand rendering.
• Download – Download the feed as a CSV file
• Manage Fields – Configure which fields are included and how they're named
• Edit – Modify feed settings (name, designs, delivery, etc.)
• Delete – Remove the feed permanently

Campaign Image Manager (Meta only)

For Meta feeds, the Campaign Image Manager lets you assign any of your design images (including additional images) as the image a specific campaign or ad displays — without changing the catalog for other campaigns:

• Select a campaign (and optionally specific ads) and pick which design it should show
• CataBoost updates the ad creatives via Meta's API to point at that design's image tag — the tagged images themselves reach the catalog through your supplemental feed
• Available via the target icon on Meta feed rows (all API feeds, plus file/URL supplemental feeds)
• Works with file/URL-delivered supplemental feeds too: connect your Meta account from inside the manager — that connection is used only for campaign image assignment, while your feed stays on manual/URL delivery. Make sure the supplemental feed is added to the same catalog as a data source (and has been fetched by Meta) so the tagged images are actually there

Feed URL

After creating a feed, you'll get a unique Feed URL:

• Copy this URL and paste it in your advertising platform
• The feed updates automatically when you make changes to designs or products
• Products get fresh creatives based on your latest designs

Refresh Schedule

Set how often your feed automatically regenerates:

• Manual – Only regenerate when you click the button
• Hourly / Daily / Weekly / Monthly – Automatically regenerate on a schedule to keep data fresh

Example Rules

• When a product goes on sale, apply the "Sale Badge" design
• When a product is low stock, show "Limited Availability" banner
• During holiday season, add "Holiday Theme" overlay
• When price drops below a threshold, apply a "Deal" design

Creating a Rule

1. Click "Create Rule"
2. Name – Describe what this rule does (e.g., "Apply sale design to discounted items")
3. Trigger – Define when the rule activates:
   • Product attribute changes (price, sale_price, availability, etc.)
   • Date/time based (holidays, weekends, specific date ranges)
   • Custom conditions (any product field matches a value)
4. Action – What happens when triggered:
   • Apply a specific design
   • Add to a Product Set
   • Update in Output Feed
5. Activate – Turn the rule on!

Managing Rules

• Toggle On/Off – Quickly enable or disable rules without deleting them
• Edit – Modify rule conditions at any time
• Delete – Remove rules you no longer need
• See Matched Products – View which products currently match each rule

Connecting Ad Platforms

Connect one or more ad platforms to pull in performance data:

• Google Ads – Connect your Google Ads account to see Shopping campaign performance
• Meta Ads – Connect Meta to see Facebook and Instagram ad performance
• TikTok Ads – Connect TikTok to see product-level ad performance

Data is synced automatically and can be refreshed on demand.

Performance Overview

• Summary Cards – See total revenue, ad spend, ROAS, clicks, impressions, and CTR at a glance
• Date Range – Filter by last 7, 14, 30, 90 days, this month, last month, or custom dates
• Comparison – Compare against previous period, previous month, or previous year
• Charts – Visualize revenue vs spend over time, profitability scatter plots, and spend distribution

SKU Performance Table

• See every product's ad performance: revenue, spend, ROAS, impressions, clicks, CTR, CPC, and conversions
• Sort by any column to find top/bottom performers
• Search by product ID or title
• Export to CSV for offline analysis
• Product thumbnails for easy identification

Optimization Rules

Set up automatic rules to optimize your feed based on ad performance:

• Reduce Wasted Ad Spend – Automatically exclude products with high spend but zero revenue
• Boost Top Performers – Prioritize products with the best CTR in your feed
• Toggle On/Off – Activate or deactivate rules instantly

Rules are evaluated automatically and take effect immediately when toggled.

Brand Settings

Set up your brand once, use it everywhere:

• Logo – Upload your company logo to use in designs
• Colors – Define your brand color palette for consistent styling
• Website – Enter your URL to auto-detect brand assets

Uploaded Assets

Store images, graphics, and other media for easy access:

• Upload – Drag and drop or click to upload files (JPG, PNG, SVG, WebP, GIF)
• Organize – Your assets are automatically categorized
• Use in Builder – Easily insert assets into your designs from the sidebar
• Download – Save assets back to your computer

Managing Stores

• Add a Store – Click "Add Store" to create a new workspace
• Switch Stores – Use the store selector at the top of the screen to switch between stores
• Edit Store – Update the store name or settings
• Delete Store – Remove stores you no longer need

Per-Store Data

Each store has its own independent:

• Product feeds & product sets
• Designs & templates
• Output feeds & platform connections
• Brand settings & asset library
• Automation rules

This keeps everything organized and separate between brands!

Sharing Stores (Business & Agency Plans)

Invite team members to collaborate on specific stores:

1. Open the store you want to share
2. Click "Share" or the people icon
3. Enter the email address of your teammate
4. They'll receive an invitation to access the store

Available Plans

Managing Your Subscription

• Upgrade – Switch to a higher plan anytime (prorated)
• Downgrade – Switch to a lower plan at the end of your billing period
• Cancel – Cancel your subscription (you'll keep access until the period ends)
• Payment Method – Update your card or payment details via the billing portal