In the latest version of Discourse, outlet arguments can be accessed as top-level arguments to your connector components. In a template, that means that @outletArgs.foo can be replaced with @foo. In Glimmer Component JS, this.args.outletArgs.foo can be replaced with this.args.foo. The old @outletArgs argument is still available, and we don’t have any plans to deprecate it. So there’s no rush to update any existing code. In the future we may introduce a custom eslint rule to detect & automatically modernize uses of @outletArgs and this.args.outletArgs. The plugin outlet inspector has already been updated to display arguments in the modern way: [SCR-20250618-lajw] We’ll be following up with changes to documentation in the near future.

Pardon my ignorance, but where do you access these args? In a connector .gjs file? Or in a renderInOutlet?

There are two ways to render a connector component into a plugin outlet. One is to place your component in /connectors/{outlet-name}/my-connector.gjs (or a .js/.hbs combo). The other way is to author your component elsewhere, and call api.renderInOutlet("{outlet-name}", MyConnectorComponent) In both cases, the outlet args will be passed through to your component. [image] Theme Developer Tutorial: 4. Using Outlets to insert and replace content Developer Guides Discourse uses the Ember JS Framework for its user interface. On top of Ember, Discourse provides a number of APIs to allow themes to customize the user interface. The most commonly-used API is Plugin Outlets. These outlets are positioned throughout Discourse core, and allow themes to render Ember Components inside them. Those components are given access to some contextual information called “outlet args”. Some outlets also “wrap” part of the core user interface, which allows themes to add the…

@outletArgs are now available as top-level arguments

Development

merefield (Robert) June 18, 2025, 11:17am 2

Much more consistent

Topic		Replies	Views
Using Plugin Outlet Connectors from a Theme or Plugin Developer Guides how-to , code	12	19537	October 14, 2024
Theme Developer Tutorial: 4. Using Outlets to insert and replace content Developer Guides	0	1261	March 18, 2025
Using discourse's plugin outlets Development	2	1191	September 24, 2020
Developing Discourse Plugins - Part 2 - Connect to a plugin outlet Developer Guides plugin-guides , tutorial	38	30987	November 23, 2025
Using a Discourse component in a plugin Development	19	4758	January 26, 2017

@outletArgs are now available as top-level arguments

Related topics