Skip to content

Getting Started

Jump to bottom
Nick edited this page Mar 8, 2026 · 1 revision

Getting Started

This guide walks you through installing Dispatch for Telex and connecting it to your Telex account for the first time.

Requirements

Requirement Minimum
WordPress 6.7
PHP 8.2
MySQL / MariaDB 8.0 / 10.5
Telex account telex.automattic.ai

Multisite: Dispatch is fully multisite-compatible. Install and activate network-wide, connect once at the network level, and every site on the network shares the connection. See Multisite Setup.

Installation

From the WordPress Plugin Directory

  1. Go to Plugins → Add New Plugin in your WordPress admin.
  2. Search for Dispatch for Telex.
  3. Click Install Now, then Activate.

Manual Installation

  1. Download the latest release zip from GitHub Releases.
  2. Go to Plugins → Add New Plugin → Upload Plugin.
  3. Upload the zip and activate.

Via WP-CLI

wp plugin install dispatch-for-telex --activate

Connecting to Telex

Dispatch uses the OAuth 2.0 Device Authorization Grant (RFC 8628). No passwords are stored anywhere.

  1. Click Dispatch in the WordPress admin sidebar.
  2. Click Connect to Telex.
  3. Dispatch shows a short code and a URL (e.g. telex.automattic.ai/activate).
  4. Open that URL on any device — your phone, another tab, anywhere.
  5. Sign into Telex and enter the code.
  6. Return to your WordPress admin. Dispatch detects the authorization automatically and loads your projects.

Headless / server environments: Run wp telex connect from the terminal. It prints the URL and code, polls for completion, and confirms when connected. See WP-CLI Reference.

After Connecting

Your full Telex project library appears in a searchable list. From here you can install any block or theme with one click, update projects when new builds are available, and remove anything you no longer need.

Continue to Managing Projects for the full walkthrough.

Disconnecting

Go to the Dispatch admin screen and click Disconnect. This removes the stored OAuth token. Already-installed projects remain on your site and keep working.

wp telex disconnect

Clone this wiki locally