Using the Editor through Kong Manager

    • Kong Gateway 1.3 or later
    • Access to Kong Manager

    Enter Editor Mode

    From the Kong Manager dashboard of your Workspace, click Editor under Dev Portal in the sidebar.

    Launch Editor Mode

    This will launch the Editor Mode:

    When enabled, the Dev Portal is pre-populated with Kong’s default theme. The file editor exposes these files to the UI, allowing them to be edited quickly and easily from inside the browser. When you first open the editor, you will be presented with a list of files on the left, and a blank editing form.

    1. Create new files for the Dev Portal right from the Editor by clicking .
    2. List of all exposed template files in the Dev Portal, separated by Content / Spec / Themes.
    3. Code View - Select a file from the sidebar to show the code here.
    4. Portal Preview - View a live preview of the selected Dev Portal file.

    Editing Files

    Select a file from the sidebar to open it for editing. This will expose the file to the Code View and show a live update in the Portal Preview. Clicking Save in the top right corner will save the updates to the database and update the file on the Dev Portal.

    Editing a File

    Clicking the button opens the New File Dialog.

    Once created, files will immediately be available from within the Editor.

    Authenticating files

    Authentication is handled by value on content pages (for gui view, go to permissions page) - set readable_by: ‘*’ to equal old authenticated - to restrict access to certain roles, set readable_by to an array of accepted roles (you must first create roles on the permissions page) - on specs, readable_by is set inside “x-headmatter” object

    To delete a file from within the Editor, right click on the file name and select Delete from the popup menu.

    NOTE: This action cannot be undone.