Step 6: Create a New Version

In this step, you edit the Replicated Config custom resource file to create a new field on the admin console Config page. You then promote the new release to the Unstable channel with your changes.

To create and promote a new version of the application:

From the vendor portal, click Releases > Create Release.

The YAML editor opens and shows the contents of the most recently created release. This gives you everything that you have done so far.

In the kots-config.yaml file, copy and paste the following YAML into the file under the example_default_value field to create a new text field on the admin console Config page:

- name: more_text
  title: Another Text Example
  type: text
  value: ""
  when: repl{{ ConfigOptionEquals "show_text_inputs" "1" }}

The following shows the full YAML for the kots-config.yaml file after you add the new field:

apiVersion: kots.io/v1beta1
kind: Config
metadata:
  name: config-sample
spec:
  groups:
  - name: example_settings
    title: My Example Config
    description: Configuration to serve as an example for creating your own. See [https://kots.io/reference/v1beta1/config/](https://kots.io/reference/v1beta1/config/) for configuration docs. In this case, we provide example fields for configuring an Nginx welcome page.
    items:
    - name: show_text_inputs
      title: Customize Text Inputs
      help_text: "Show custom user text inputs"
      type: bool
      default: "0"
      recommended: true
    - name: example_default_value
      title: Text Example (with default value)
      type: text
      value: ""
      default: please change this value
      when: repl{{ ConfigOptionEquals "show_text_inputs" "1" }}
      # Add the new more_text field here
    - name: more_text
      title: Another Text Example
      type: text
      value: ""
      when: repl{{ ConfigOptionEquals "show_text_inputs" "1" }}
    - name: api_token
      title: API token
      type: password
      props:
        rows: 5
      when: repl{{ ConfigOptionEquals "show_text_inputs" "1" }}
    - name: readonly_text_left
      title: Readonly Text
      type: text
      value: "{{repl RandomString 10}}"
      readonly: true
      when: repl{{ ConfigOptionEquals "show_text_inputs" "1" }}
    - name: hidden_text
      title: Secret Key
      type: password
      hidden: true
      value: "{{repl RandomString 40}}"

Check the linter messages in the Help pane to ensure there are no errors.
In the example-configmap.yaml file, copy and paste the following HTML to replace the <body> section:
```
<body>
 This is an example KOTS application.
 This is text from a user config value: '{{repl ConfigOption "example_default_value"}}' 
 This is more text from a user config value: '{{repl ConfigOption "more_text"}}' 
 This is a hidden value: '{{repl ConfigOption "hidden_text"}}'
</body>
```
This creates a reference to the more_text field using a Replicated KOTS template function. The ConfigOption template function renders the user input from the configuration item that you specify. For more information, see Config Context in Reference.
Check the linter messages in the Help pane to ensure there are no errors.
Click Save Release.
Promote the release to a channel:
1. Click Promote at the top of the page.
2. Choose the Unstable channel in the Promote Release dialog, and click Promote.
Any license installed from the Unstable channel will start with this new release, and any installation already running is prompted to update to the new release when the admin console checks for updates.

Next Step

Continue to Step 7: Update the Application to return to the admin console to update the application to the new version.

Step 6: Create a New Version

Next Step​

Next Step