Install a container (with a tracking code)

Administration

Needed permissions: owner

Video tutorial: watch on YouTube

Piwik PRO uses a container to let you manage tags and consents, and run a tracking code (a JavaScript code) on your web pages. The tracking code collects data about people who visit your site or app. Every time a visitor views a page, the tracking code grabs information about that visitor and sends it to Piwik PRO. Then Piwik PRO organizes this data into reports.

To install a container, follow these steps:

  1. Go to Menu > Administration.
  2. Navigate to Sites & apps.
  3. Click Add a site or app.
  4. Type the site or app name and address and click Save.
    Site or app address (Administration)

    Note: If you want to track a few domains with the same tracking code, add their addresses.

  5. Set the time zone and currency.
    Time zone and currency (administration)

    Note: We’ll show data in reports in this time zone. We’ll use this currency for goal revenue.

  6. Navigate to Installation.
  7. In Sites, click Install manually.
  8. In Basic container (async), click Copy to clipboard.
    Install Piwik PRO

    Note: This container holds your tracking code and is used to handle most tags. Always install this container.

  9. Paste the code right after the opening <body> tag on every page of your website or app.
  10. Data will appear in reports in about an hour. Data in the tracker debugger will appear instantly.

    Tip: You can also check manually to see if your tracking works. Read more

  11. We’ll start showing a consent form on your site after you’ve installed the container. Add your privacy policy address to the form or turn off the consent form.
  12. (Optional) (Deprecated) In Additional container (sync), click Copy to clipboard.
    Install additional container in Piwik PRO

    Note: Add this container if you want to use sync tags. It loads tags before the page content loads. But always install the Basic container (async), otherwise the additional one won’t work.

    Note: Synchronous containers and tags will be discontinued by January, 2025. We recommend removing them and adjusting your setups accordingly. Read more

  13. (Optional) Paste the code inside <head></head> tags on your website or app. Don’t add this code elsewhere because it may slow down your site and affect tracking.
  14. (Optional) You can start adding sync tags right away.

Tip: To change the way your data is collected, you can use the following settings:

Was this article helpful?

Technical support

If you still have any questions, visit our community.
There’s always someone happy to help!

Back to help center