All Products
Search
Document Center

OpenSearch:Perform offline changes

Last Updated:Apr 01, 2026

Offline changes let you modify an application's schema or switch its data source without interrupting the live search service. Use this workflow when you need to:

  • Add or remove fields

  • Create or modify indexes

  • Add, modify, or remove attributes

  • Add or remove default display fields

  • Switch the data source

Before you begin

Identify which version state applies to your application. The steps differ depending on your situation:

StateDescriptionWhat happens when you click Modify Offline Application
Online version onlyNo offline version existsThe Modify Application page opens. After you save, an offline version is created and coexists with the online version.
Both versions existAn offline version already existsThe Modify Offline Application page opens, showing the current offline version. Click Configure to edit it. Saving replaces the previous offline version with a new one.
Online version is InvalidThe online version is in the Invalid stateDelete the application and reconfigure it from scratch. You cannot perform offline changes in this state.
If both versions exist, offline changes always target the offline version. To make changes to the online version directly, delete the offline version first.

Modify an application offline

  1. Log on to the OpenSearch console. In the upper-left corner, move the pointer over the edition label and select OpenSearch High-performance Search Edition. The Instance Management page opens by default. Find the target application and click Details in the Actions column.

    image

  2. On the Online Application tab of the Application Details page, click Modify Offline Application.

    image

  3. On the Modify Application page, update the schema as needed:

    • Edit fields. image

    • Edit indexes, attributes, or default display fields. image

    • Edit the data source and update the field mapping. image

  4. Modify the sorting of search results.

    image

  5. Choose how to handle incremental data sync and publishing. Incremental data sync — Choose whether to sync incremental data to the offline version while it is being created: Publishing — Choose whether to publish automatically or manually:

    OptionEffect
    No — sync manually or via APIData is not synchronized to the offline version when the offline version is being created. Incremental data continues to go to the online version. Synchronize data to the offline application from the data source, or push full data to the offline application by using the API.
    OptionEffect
    No — publish manuallyGo to the Offline Application tab on the Application Details page and click Publish when ready.

    image

    image