---
title: Shortcodes
description: Place a cart launcher anywhere with the launcher shortcode, and choose its icon, count and total.
sidebar:
  label: Shortcodes
  icon: code
---

CartPops registers one shortcode, in two spellings. It shows a cart button with an item count that opens the cart drawer. Use it in your header, a page, a widget or a theme template. It is similar to the cart icon many themes show in the menu, with more control.

The two spellings do the same thing:

- `[cartpops_launcher]` is the current name.
- `[cartpops_cart_launcher]` is the name CartPops V1 used. It still works, so your existing shortcodes keep working after you upgrade.

## Basic use

```text
[cartpops_launcher]
```

This shows a shopping cart icon, a count badge and the cart total. It sits in the flow of the page, unlike the [floating launcher](/guides/launcher).

You can use it:

- In a **Shortcode** block in the Site Editor or the block editor.
- In a Custom HTML or text widget that supports shortcodes.
- In a theme template, with PHP:

```php header.php
<?php echo do_shortcode( '[cartpops_launcher indicator="none"]' ); ?>
```

## Options

| Option | Values | Default | What it does |
| --- | --- | --- | --- |
| `icon` | `cart`, `bag`, `basket` | `cart` | The icon shown on the button. |
| `indicator` | `none`, `bubble`, `plain` | `bubble` | How the item count appears. `none` hides it, `bubble` puts it in a badge and `plain` shows the number without a badge. |
| `subtotal` | `true`, `false` | `true` | Show or hide the cart total. |
| `indicator_hide_empty` | `true`, `false` | `false` | Hide the count while the cart is empty. |
| `hide_empty` | `true`, `false` | `false` | Hide the whole launcher while the cart is empty. |

Yes/no options also accept `yes`, `no`, `on`, `off`, `1` and `0`. An invalid value falls back to the default.

### Icons from V1

V1 used icon names that start with `cpops-icon-`. Those still work, but V2 has three icons, so each one maps to the nearest match. The V1 shopping cart names become `cart`. The V1 shopping bag and handbag names become `bag`. A name CartPops does not recognize falls back to `cart`.

V1 also let you pass your own icon name and style it with CSS. That no longer works. A custom icon name shows the default cart icon.

## Examples you can copy

Default launcher:

```text
[cartpops_launcher]
```

A bag icon with no count and no total:

```text
[cartpops_launcher icon="bag" indicator="none" subtotal="false"]
```

A cart with a plain count and no total:

```text
[cartpops_launcher indicator="plain" subtotal="false"]
```

Hide the launcher until the cart has items:

```text
[cartpops_launcher hide_empty="true"]
```

## Colors

A shortcode launcher uses the colors under **Inline launcher appearance** on the **Launcher** page (**WooCommerce** > **CartPops** > **Launcher**): **Inline Background**, **Inline Text**, **Inline Badge Background** and **Inline Badge Text**. They apply to every inline launcher on the site. You can't set colors per shortcode.

For anything beyond that, add CSS in **Advanced** > **General** > **Custom CSS**. The launcher button has the classes `cpops-launcher` and `cpops-launcher--inline`.

## Good to know

- The shortcode renders nothing when CartPops is turned off (**Advanced** > **General** > **Enable CartPops**) or when WooCommerce has no cart available.
- **Hide launcher on pages** doesn't apply to shortcode launchers. It only hides the floating launcher.
- A page can hold several shortcode launchers. They all open the same drawer.