elastic · jughosta · Sep 17, 2025 · Sep 12, 2025 · Sep 12, 2025 · Sep 12, 2025
@@ -17,6 +17,7 @@ import useDebounce from 'react-use/lib/useDebounce';
 import { useEuiTablePersist } from '@kbn/shared-ux-table-persist';
 import { TableText } from '..';
 import { SEARCH_SESSIONS_TABLE_ID } from '../../../../../../common';
+import { BACKGROUND_SEARCH_FEATURE_FLAG_KEY } from '../../../constants';
 import type { SearchSessionsMgmtAPI } from '../../lib/api';
 import { getColumns as getDefaultColumns } from './columns/get_columns';
 import type { BackgroundSearchOpenedHandler, LocatorsStart, UISession } from '../../types';
@@ -75,6 +76,12 @@ export function SearchSessionsMgmtTable({
     () => moment.duration(config.management.refreshInterval).asMilliseconds(),
     [config.management.refreshInterval]
   );
+  const enableOpeningInNewTab = useMemo(
+    () =>
+      core.featureFlags.getBooleanValue(BACKGROUND_SEARCH_FEATURE_FLAG_KEY, false) &&
+      core.featureFlags.getBooleanValue('discover.tabsEnabled', false),
+    [core.featureFlags]
+  );
 
   const { pageSize, sorting, onTableChange } = useEuiTablePersist<UISession>({
     tableId: 'searchSessionsMgmt',
@@ -111,7 +118,12 @@ export function SearchSessionsMgmtTable({
       try {
         const { savedObjects, statuses } = await api.fetchTableData({ appId });
         results = savedObjects.map((savedObject) =>
-          mapToUISession({ savedObject, locators, sessionStatuses: statuses })
+          mapToUISession({
+            savedObject,
+            locators,
+            sessionStatuses: statuses,
+            enableOpeningInNewTab,
+          })
         );
       } catch (e) {} // eslint-disable-line no-empty
 
@@ -125,7 +137,7 @@ export function SearchSessionsMgmtTable({
       if (refreshTimeoutRef.current) clearTimeout(refreshTimeoutRef.current);
       refreshTimeoutRef.current = window.setTimeout(doRefresh, refreshInterval);
     }
-  }, [api, refreshInterval, locators, appId]);
+  }, [api, refreshInterval, locators, appId, enableOpeningInNewTab]);
 
   // initial data load
   useEffect(() => {

@@ -30,11 +30,13 @@ export const mapToUISession = ({
   locators,
   sessionStatuses,
   actions: filteredActions,
+  enableOpeningInNewTab,
 }: {
   savedObject: SearchSessionSavedObject;
   locators: LocatorsStart;
   sessionStatuses: SearchSessionsFindResponse['statuses'];
   actions?: ACTION[];
+  enableOpeningInNewTab?: boolean;
 }): UISession => {
   const {
     name,
@@ -59,7 +61,17 @@ export const mapToUISession = ({
   if (initialState) delete initialState.searchSessionId;
   // derive the URL and add it in
   const reloadUrl = getUrlFromState(locators, locatorId, initialState);
-  const restoreUrl = getUrlFromState(locators, locatorId, restoreState);
+  const restoreUrl = getUrlFromState(
+    locators,
+    locatorId,
+    enableOpeningInNewTab
+      ? {
+          ...restoreState,
+          tabId: 'new',
+          tabLabel: name,
+        }
+      : restoreState
+  );
 
   return {
     id: savedObject.id,

@@ -236,6 +236,31 @@ describe('Discover url generator', () => {
     expect(path).toContain('__test__');
   });
 
+  test('can specify a tab id', async () => {
+    const { locator } = await setup();
+    const { path } = await locator.getLocation({
+      tabId: '__test__',
+    });
+
+    expect(path).toMatchInlineSnapshot(`"#/?_tabs=(tabId:__test__)"`);
+  });
+
+  test('can specify to open in a new tab', async () => {
+    const { locator } = await setup();
+    const { path } = await locator.getLocation({
+      tabId: 'new',
+      tabLabel: 'My new tab',
+      query: {
+        esql: 'SELECT * FROM test',
+      },
+      searchSessionId: '__test__',
+    });
+
+    expect(path).toMatchInlineSnapshot(
+      `"#/?searchSessionId=__test__&_a=(dataSource:(type:esql),query:(esql:'SELECT%20*%20FROM%20test'))&_tabs=(tabId:new,tabLabel:'My%20new%20tab')"`
+    );
+  });
+
   test('can specify columns, grid, interval, sort and savedQuery', async () => {
     const { locator } = await setup();
     const { path } = await locator.getLocation({

@@ -13,7 +13,7 @@ import type { RefreshInterval } from '@kbn/data-plugin/public';
 import type { LocatorDefinition, LocatorPublic } from '@kbn/share-plugin/public';
 import type { DiscoverGridSettings } from '@kbn/saved-search-plugin/common';
 import type { DataViewSpec } from '@kbn/data-views-plugin/common';
-import type { VIEW_MODE } from './constants';
+import type { VIEW_MODE, NEW_TAB_ID } from './constants';
 
 export const DISCOVER_APP_LOCATOR = 'DISCOVER_APP_LOCATOR';
 
@@ -65,6 +65,19 @@ export interface DiscoverAppLocatorParams extends SerializableRecord {
    */
   searchSessionId?: string;
 
+  /**
+   * Optionally set Discover tab ID.
+   * Use `new` as value to indicate that a new tab should be created.
+   * Once created, the new tab will have a unique id which can be referenced too if necessary.
+   */
+  tabId?: string | typeof NEW_TAB_ID;
+
+  /**
+   * Optional label for the tab, used when `tabId` is `new` to set the initial label of the newly created tab.
+   * If not provided, a default label will be assigned.
+   */
+  tabLabel?: string;
+
   /**
    * Columns displayed in the table
    */

@@ -13,7 +13,7 @@ import type { setStateToKbnUrl as setStateToKbnUrlCommon } from '@kbn/kibana-uti
 import type { DiscoverAppLocatorGetLocation, MainHistoryLocationState } from './app_locator';
 import type { DiscoverAppState } from '../public';
 import { createDataViewDataSource, createEsqlDataSource } from './data_sources';
-import { APP_STATE_URL_KEY } from './constants';
+import { APP_STATE_URL_KEY, GLOBAL_STATE_URL_KEY, TABS_STATE_URL_KEY } from './constants';
 
 export const appLocatorGetLocationCommon = async (
   {
@@ -45,6 +45,8 @@ export const appLocatorGetLocationCommon = async (
     hideAggregatedPreview,
     breakdownField,
     isAlertResults,
+    tabId,
+    tabLabel,
   } = params;
   const savedSearchPath = savedSearchId ? `view/${encodeURIComponent(savedSearchId)}` : '';
   const appState: Partial<DiscoverAppState> = {};
@@ -79,13 +81,22 @@ export const appLocatorGetLocationCommon = async (
   }
 
   if (Object.keys(queryState).length) {
-    path = setStateToKbnUrl<GlobalQueryStateFromUrl>('_g', queryState, { useHash }, path);
+    path = setStateToKbnUrl<GlobalQueryStateFromUrl>(
+      GLOBAL_STATE_URL_KEY,
+      queryState,
+      { useHash },
+      path
+    );
   }
 
   if (Object.keys(appState).length) {
     path = setStateToKbnUrl(APP_STATE_URL_KEY, appState, { useHash }, path);
   }
 
+  if (tabId) {
+    path = setStateToKbnUrl(TABS_STATE_URL_KEY, { tabId, tabLabel }, { useHash }, path);
+  }
+
   return {
     app: 'discover',
     path,

@@ -26,12 +26,19 @@ export const getDefaultRowsPerPage = (uiSettings: IUiSettingsClient): number =>
 // local storage key for the ES|QL to Dataviews transition modal
 export const ESQL_TRANSITION_MODAL_KEY = 'data.textLangTransitionModal';
 
+/**
+ * The id value used to indicate that a link should open in a new Discover tab.
+ * It will be used in the `_tabs` URL param to indicate that a new tab should be created.
+ * Once created, the new tab will have a unique id.
+ */
+export const NEW_TAB_ID = 'new' as const;
+
 /**
  * The query param key used to store the Discover app state in the URL
  */
 export const APP_STATE_URL_KEY = '_a';
 export const GLOBAL_STATE_URL_KEY = '_g';
-export const TABS_STATE_URL_KEY = '_t';
+export const TABS_STATE_URL_KEY = '_tabs'; // `_t` is already used by Kibana for time, so we use `_tabs` here
 
 /**
  * Product feature IDs

@@ -70,6 +70,8 @@ export const getShareAppMenuItem = ({
       timeRange,
       refreshInterval,
     };
+
+    // TODO: for a persisted saved search, add the current tab ID to the params
     const relativeUrl = locator.getRedirectUrl(params);
 
     // This logic is duplicated from `relativeToAbsolute` (for bundle size reasons). Ultimately, this should be

@@ -41,7 +41,7 @@ export const useStateManagers = ({
     TABS_ENABLED_FEATURE_FLAG_KEY,
     false
   );
-  // syncing with the _t part URL
+  // syncing with the _tabs part URL
   const [tabsStorageManager] = useState(() =>
     createTabsStorageManager({
       urlStateStorage,
@@ -63,13 +63,13 @@ export const useStateManagers = ({
 
   useEffect(() => {
     const stopUrlSync = tabsStorageManager.startUrlSync({
-      // if `_t` in URL changes (for example via browser history), try to restore the previous state
+      // if `_tabs` in URL changes (for example via browser history), try to restore the previous state
       onChanged: (urlState) => {
         const { tabId: restoreTabId } = urlState;
         if (restoreTabId) {
           internalState.dispatch(internalStateActions.restoreTab({ restoreTabId }));
         } else {
-          // if tabId is not present in `_t`, clear all tabs
+          // if tabId is not present in `_tabs`, clear all tabs
           internalState.dispatch(internalStateActions.clearAllTabs());
         }
       },

@@ -29,7 +29,11 @@ import {
   selectInitialUnifiedHistogramLayoutPropsMap,
   selectTabRuntimeInternalState,
 } from '../runtime_state';
-import { APP_STATE_URL_KEY, GLOBAL_STATE_URL_KEY } from '../../../../../../common/constants';
+import {
+  APP_STATE_URL_KEY,
+  GLOBAL_STATE_URL_KEY,
+  NEW_TAB_ID,
+} from '../../../../../../common/constants';
 import type { DiscoverAppState } from '../../discover_app_state_container';
 import { createInternalStateAsyncThunk, createTabItem } from '../utils';
 import { setBreadcrumbs } from '../../../../../utils/breadcrumbs';
@@ -113,6 +117,21 @@ export const updateTabs: InternalStateThunkActionCreator<[TabbedContentState], P
       };
 
       if (!existingTab) {
+        tab.initialAppState =
+          'initialAppState' in item
+            ? cloneDeep(item.initialAppState as TabState['initialAppState'])
+            : tab.initialAppState;
+
+        tab.globalState =
+          'globalState' in item
+            ? cloneDeep(item.globalState as TabState['globalState'])
+            : tab.globalState;
+
+        tab.dataRequestParams =
+          'dataRequestParams' in item
+            ? (item.dataRequestParams as TabState['dataRequestParams'])
+            : tab.dataRequestParams;
+
         if (item.duplicatedFromId) {
           // the new tab was created by duplicating an existing tab
           const existingTabToDuplicateFrom = selectTab(currentState, item.duplicatedFromId);
@@ -288,7 +307,7 @@ export const restoreTab: InternalStateThunkActionCreator<[{ restoreTabId: string
   (dispatch, getState) => {
     const currentState = getState();
 
-    if (restoreTabId === currentState.tabs.unsafeCurrentId) {
+    if (restoreTabId === currentState.tabs.unsafeCurrentId || restoreTabId === NEW_TAB_ID) {
       return;
     }
 
@@ -318,6 +337,46 @@ export const restoreTab: InternalStateThunkActionCreator<[{ restoreTabId: string
     );
   };
 
+export const openInNewTab: InternalStateThunkActionCreator<
+  [
+    {
+      tabLabel?: string;
+      appState?: TabState['initialAppState'];
+      globalState?: TabState['globalState'];
+      searchSessionId?: string;
+    }
+  ]
+> =
+  ({ tabLabel, appState, globalState, searchSessionId }) =>
+  (dispatch, getState) => {
+    const initialAppState = appState ? cloneDeep(appState) : undefined;
+    const initialGlobalState = globalState ? cloneDeep(globalState) : {};
+    const currentState = getState();
+    const currentTabs = selectAllTabs(currentState);
+
+    const newDefaultTab: TabState = {
+      ...DEFAULT_TAB_STATE,
+      ...createTabItem(currentTabs),
+      initialAppState,
+      globalState: initialGlobalState,
+    };
+
+    if (tabLabel) {
+      newDefaultTab.label = tabLabel;
+    }
+
+    if (searchSessionId) {
+      newDefaultTab.dataRequestParams = {
+        ...newDefaultTab.dataRequestParams,
+        searchSessionId,
+      };
+    }
+
+    return dispatch(
+      updateTabs({ items: [...currentTabs, newDefaultTab], selectedItem: newDefaultTab })
+    );
+  };
+
 export const disconnectTab: InternalStateThunkActionCreator<[TabActionPayload]> =
   ({ tabId }) =>
   (_, __, { runtimeStateManager }) => {

@@ -21,6 +21,7 @@ import {
   updateTabs,
   disconnectTab,
   restoreTab,
+  openInNewTab,
   clearAllTabs,
   initializeTabs,
   saveDiscoverSession,
@@ -56,6 +57,7 @@ export const internalStateActions = {
   initializeSingleTab,
   syncLocallyPersistedTabState,
   restoreTab,
+  openInNewTab,
   clearAllTabs,
   initializeTabs,
   saveDiscoverSession,