Installation

Requirements

• Craft CMS 5.0 or later
• PHP 8.2 or later
• The json and openssl PHP extensions — both standard on virtually every install. openssl is what signs the service account assertion.
• A Google Analytics 4 property, and enough access to it to add a user

There are no runtime Composer dependencies beyond Craft itself.

Install via Composer

Open your terminal in your project root and run:

composer require justinholtweb/craft-telescope

Install the plugin

Then install it via the Craft CLI:

php craft plugin/install telescope

Or go to Settings → Plugins in the control panel and click “Install” next to Telescope.

Next steps

Telescope will not have anything to show until it can reach your GA4 property. Head to Connecting to GA4 to create a service account and enter your property ID, then run:

php craft telescope/analytics/check

to confirm the credentials, property access and API connectivity all work.