Documentation

Embed Your Shop

Add your shop to Ghost via the API or by pasting embed code.

Option 1: Auto-Publish to Ghost (Recommended)

If you've connected your Ghost Admin API key, you can publish your shop directly from xVoid.

  1. Go to Storefront in your dashboard
  2. Customize your theme and display settings
  3. Set your Page Slug (e.g. shop)
  4. Click Publish to Ghost
  5. Your shop is live at yoursite.com/shop

Any changes you make to your storefront theme will auto-update the published page.

Option 2: Manual Embed Code

  1. Go to Storefront in your dashboard
  2. Click Copy Code
  3. In Ghost Admin, create a new page
  4. Add an HTML card
  5. Paste the embed code
  6. Publish the page

Adding the Cart Button

The cart button is a separate snippet that adds a floating cart icon to every page on your site.

  1. Go to Storefront → Cart Code
  2. Copy the cart widget code
  3. In Ghost Admin, go to Settings → Code injection
  4. Paste the code in the Site footer section
  5. Click Save

The cart button floats in the corner and shows the item count. It works on every page, not just your shop.

Customizing Appearance

Go to Storefront → Theme to customize how your shop looks. You can adjust:

  • Colors - background, card, text, borders, accent, and sale badge
  • Fonts - heading and body fonts from Google Fonts
  • Button style - square, rounded, or pill
  • Display options - stock badges, tag pills, and product click behavior

Product Click Behavior

Under Display Options, you can choose what happens when a customer clicks a product:

  • Modal Popup (default) - opens a popup overlay with product details
  • Ghost Page - links to the full Ghost page (requires Ghost integration and published product pages)

Last updated