Skip to main content


Kicks off a loading spinner to provide context during any long-running action work. Can also be called with a single string argument as the title, or with no arguments to display only a spinner.

await ctx.loading.start({
title: "Reticulating splines...",

await ctx.loading.start("Title only shorthand");
descriptionOptional stringSecondary label providing additional context for the loading spinner.
itemsInQueueOptional numberNumber of "items" your action needs to work through to complete loading. Subsequently calling `ctx.loading.completeOne` (e.g. within a loop) updates the spinner’s progress.
titleOptional stringPrimary label for the loading spinner.

Returns: Null

Was this section useful?