---
title: "Quick start"
manual: "Cart"
version: "12.1"
permalink: "https://docs.typo3.org/permalink/extcode/cart:quick-start@12.1"
source: "QuickStart/Index.rst"
rendered: "2026-11-14T23:50:30+00:00"
---

# Quick start {#quick-start}

Watch the video and/or read the instructions to get a (minimal) working
shop setup.

> [!NOTE]
> The video shows the setup for an older version. Some parts are outdated,
> nonetheless the video still gives a good overview.
> Please also read the instructions below which work with the current version.

[Watch this video on YouTube](https://www.youtube.com/watch?v=lAu7hlRmZP8)

## Instructions {#instructions}

1.  Install this extension:

    See [Installation → Install the extension](https://docs.typo3.org/permalink/extcode/cart:installation-extension@12.1).
1.  Include the TypoScript of this extension:

    See [Installation → Include TypoScript](https://docs.typo3.org/permalink/extcode/cart:installation-typoscript@12.1).
1.  Install a product database extension

    You need to install at least one more extension to get a working shop setup.
    This other extension will offer the products itself. This can be one of the
    existing extensions or a custom extension.

    See [Other cart extensions](https://docs.typo3.org/permalink/extcode/cart:other-cart-extensions@12.1).

    The next steps of this quick start use `EXT:cart_products`.
    Include the TypoScript of this second extension as described above or as
    described in the corresponding documentation.
1.  Create the needed pages and directories in the TYPO3 backend.

    ![Page setup for a minimal shop](../Images/QuickStart/Page-Tree.png)

    1.  Create a page for cart. Here it's named *Cart*.
    1.  Create a page for a list of products. Here it's named *Products*.
    1.  Create a page for the detail view of a product. Here it's named *Detail*.
    1.  Create a page of type "directory" where the products will be stored.
        Here it's named *Products Storage*.
    1.  Create a page of type "directory" where the orders will be stored.
        Here it's named *Orders*.

    > [!TIP]
    > You can create multiple, even nested, directories to organize your
    > products in the backend.
    >
    > In this case you can even have multiple pages for lists and detail views.
1.  Create Plugin for the cart

    ![Settings within the plugin "Cart: Cart"](../Images/QuickStart/Plugin-Cart-Cart.png)

    On the page *Cart*:

    -   Create a record of type plugin *Cart: Cart*.
1.  Create Plugin for the list view

    ![Settings within the plugin "Cart: Products" for the list view](../Images/QuickStart/Plugin-Cart-Products-List.png)

    On the page *Products*:

    -   Create a record of type plugin *Cart: Products* and make the
        following settings:

        -   Choose "Display Type" = "List (and Show) View".
        -   In *Product Detail Page* choose the page *Detail*.
        -   In *Record Storage Page* choose the page *Products Storage*.
1.  Create Plugin for the detail view

    ![Settings within the plugin "Cart: Products" for the detail view](../Images/QuickStart/Plugin-Cart-Products-Detail.png)

    On the page *Detail*:

    -   Create a record of type plugin *Cart: Products*.

        -   Choose "Display Type" = "Show View".
1.  Set TypoScript constants

    The following can be done in the TYPO3 backend in the TypoScript Module
    (as shown in the video) or better in your own sitepackage (which is
    preferred because it is under source control).

    See also [Base Configuration](https://docs.typo3.org/permalink/extcode/cart:base@12.1).

    **EXT:sitepackage/Configuration/TypoScript/constants.typoscript**

    ```typoscript
    plugin.tx_cart.settings {
        cart {
            pid = # The PID of the page "Cart".
            isNetCart = # 0 or 1, depending on your needs.
        }
        order.pid = # The PID of the page "Orders".
    }
    ```
1.  Set needed TypoScript setup

    You should set in your
    `sitepackage/Configuration/TypoScript/setup.typoscript` fitting
    values for:

    -   [email](https://docs.typo3.org/permalink/extcode/cart:mail-addresses@12.1)
    -   [payments](https://docs.typo3.org/permalink/extcode/cart:payment-methods@12.1)
    -   [shippings](https://docs.typo3.org/permalink/extcode/cart:shipping-methods@12.1)
    -   [currencies](https://docs.typo3.org/permalink/extcode/cart:currency@12.1) (only needed when not only using €),
1.  Link for consent checkboxes in the cart

    **EXT:sitepackage/Configuration/TypoScript/constants.typoscript**

    ```typoscript
    plugin.tx_cart.settings.cart {
        acceptTermsAndConditions.pid = # The PID of your terms and conditions page.
        acceptRevocationInstruction.pid = # The PID of your revocation instructions page.
        acceptPrivacyPolicy.pid = # The PID of your privacy policy page
    }
    ```
1.  Create a product

    ![Create a new record](../Images/QuickStart/New-Product-01.png)

    ![Create a new product](../Images/QuickStart/New-Product-02.png)

    -   Go to the page *Product Storage*, switch to the backend module "List".
    -   Click on **\+ Create a new record** → **Product** for a
        product which is given from the database extension (which is
        `EXT:cart_products` in this quick start).
    -   Fill in necessary product data and save.
1.  Done

    You should now be able to see the product in the frontend and make an order.
