You can configure the specifics of how a handler looks and behaves by exporting a config object with the type of Zipper.HandlerConfig from the handler file itself.

export function handler() {
export const config: Zipper.HandlerConfig = {

The config object must have the following type:

type Zipper.HandlerConfig<I = Zipper.Inputs> = {
    run?: boolean | I;
    description?: Partial<{
        title: string;
        subtitle: string;
        body: string;
    inputs?: { [Property in keyof I]: Partial<{
        label: string;
        description: string;
        defaultValue: I[Property];
        placeholder: string;
    }>; };


determines whether the app runs automatically or not. When an app is run automatically, the user doesn’t need to click the Run button. We’ll either use no inputs, the value of this key, or the default values of the inputs key.


  • true
  • false (default)
  • Inputs (e.g. { inputValue: 'something'})



optional description data that is displayed on (opens in a new tab) as headings above the inputs and output



additional information about each input. You can use these values to customize the label, placeholder, and help text of each input. You can also specify a default value that will either be prefilled on the inputs form or used if the handler is auto run.

    Sign inJoin the beta
    © 2023 Zipper, Inc. All rights reserved.