Qiskit · beckykd · Jan 16, 2026 · Jan 20, 2026 · Jan 23, 2026 · Jan 23, 2026
diff --git a/docs/guides/DAG-representation.ipynb b/docs/guides/DAG-representation.ipynb
@@ -465,8 +465,8 @@
     "## Next steps\n",
     "\n",
     "<Admonition type=\"tip\" title=\"Recommendations\">\n",
-    "    - Review the guide on creating a [custom transpiler pass](./custom-transpiler-pass)\n",
-    "    - Learn how to [Create and transpile against custom backends](./custom-backend)\n",
+    "    - Review the guide on creating a [custom transpiler pass](/docs/guides/custom-transpiler-pass)\n",
+    "    - Learn how to [Create and transpile against custom backends](/docs/guides/custom-backend)\n",
     "    - Try the [Compare transpiler settings](/docs/guides/circuit-transpilation-settings) guide.\n",
     "    - Review the [DAG Circuit API documentation](/docs/api/qiskit/dagcircuit).\n",
     "</Admonition>"

diff --git a/docs/guides/_toc.json b/docs/guides/_toc.json
@@ -238,6 +238,10 @@
                   "title": "Exact and noisy simulation with Qiskit Aer primitives",
                   "url": "/docs/guides/simulate-with-qiskit-aer"
                 },
+                {
+              "title": "Exact simulation with Qiskit SDK primitives",
+              "url": "/docs/guides/simulate-with-qiskit-sdk-primitives"
+                },
                 {
                   "title": "Build noise models",
                   "url": "/docs/guides/build-noise-models"
@@ -467,6 +471,129 @@
             }
           ]
         },
+                {
+                    "title": "Execute with primitives",
+                    "children": [
+                        {
+                            "title": "Introduction to primitives",
+                            "url": "/docs/guides/primitives"
+                        },                        {
+                            "title": "Introduction to options",
+                            "url": "/docs/guides/runtime-options-overview"
+                        },
+                        {
+                            "title": "PUBs and broadcasting",
+                            "url": "/docs/guides/pubs-broadcasting"
+                        },
+                    {
+                    "title": "Estimator",
+                    "children": [
+                            {
+                            "title": "Get started",
+                            "url": "/docs/guides/get-started-with-estimator"
+                            },
+                            {
+                            "title": "Inputs and outputs",
+                            "url": "/docs/guides/estimator-input-output"
+                            },
+                            {
+                            "title": "Broadcasting",
+                            "url": "/docs/guides/estimator-broadcasting"
+                            },
+                            {
+                            "title": "Options",
+                            "url": "/docs/guides/estimator-options"
+                            },
+                            {
+                            "title": "Examples",
+                            "url": "/docs/guides/estimator-examples"
+                            },
+                            {
+                            "title": "REST API",
+                            "url": "/docs/guides/estimator-rest-api"
+                            }
+                        ]
+                    },
+                    {
+                    "title": "Sampler",
+                    "children": [
+                            {
+                            "title": "Get started",
+                            "url": "/docs/guides/get-started-with-sampler"
+                            },
+                            {
+                            "title": "Inputs and outputs",
+                            "url": "/docs/guides/sampler-input-output"
+                            },
+                            {
+                            "title": "Options",
+                            "url": "/docs/guides/sampler-options"
+                            },
+                            {
+                            "title": "Examples",
+                            "url": "/docs/guides/sampler-examples"
+                            },
+                            {
+                            "title": "REST API",
+                            "url": "/docs/guides/sampler-rest-api"
+                            }
+                        ]
+                    },
+                    {
+                    "title": "Executor",
+                    "children": [
+                            {
+                            "title": "Get started",
+                            "url": "/docs/guides/get-started-with-executor"
+                            },
+                            {
+                            "title": "Inputs and outputs",
+                            "url": "/docs/guides/executor-input-output"
+                            },
+                            {
+                            "title": "Broadcasting",
+                            "url": "/docs/guides/executor-broadcasting"
+                            },
+                            {
+                            "title": "Options",
+                            "url": "/docs/guides/executor-options"
+                            },
+                            {
+                            "title": "Examples",
+                            "url": "/docs/guides/executor-examples"
+                            }                        ]
+                    },
+                    {
+                    "title": "Manage noise",
+                    "children": [
+                        {
+                            "title": "Error mitigation and suppression",
+                            "url": "/docs/guides/error-mitigation-and-suppression-techniques"
+                        },
+                        {
+                            "title": "Noise learning",
+                            "url": "/docs/guides/noise-learning"
+                        },
+                        {
+                            "title": "Configure error mitigation",
+                            "url": "/docs/guides/configure-error-mitigation"
+                        },
+                        {
+                            "title": "Configure error suppression",
+                            "url": "/docs/guides/configure-error-suppression"
+                        }
+                    ]
+                },
+                        {
+                            "title": "Directed execution model (beta)",
+                            "url": "/docs/guides/directed-execution-model"
+                        },
+                        {
+                            "title": "Qiskit Runtime local testing mode",
+                            "url": "/docs/guides/local-testing-mode"
+                        }
+                    ]
+                },
         {
           "title": "Execute with primitives",
           "children": [
@@ -533,6 +660,10 @@
               "title": "View backend details",
               "url": "/docs/guides/qpu-information"
             },
+            {
+              "title": "Get backend information with Qiskit",
+              "url": "/docs/guides/get-qpu-information"
+            },
             {
               "title": "Monitoring, calibrations, and benchmarking",
               "url": "/docs/guides/calibration-jobs"

diff --git a/docs/guides/ai-transpiler-passes.ipynb b/docs/guides/ai-transpiler-passes.ipynb
@@ -235,11 +235,11 @@
     "\n",
     "## Limits\n",
     "\n",
-    "Refer to the [Qiskit Transpiler Service documentation](./qiskit-transpiler-service#limits-of-the-qiskit-transpiler-service) for more information about the limits that apply to the AI-powered transpiler passes.\n",
+    "Refer to the [Qiskit Transpiler Service documentation](/docs/guides/qiskit-transpiler-service#limits-of-the-qiskit-transpiler-service) for more information about the limits that apply to the AI-powered transpiler passes.\n",
     "\n",
     "## Citation\n",
     "\n",
-    "If you use any AI-powered feature from the Qiskit Transpiler Service in your research, use [the recommended citation](./qiskit-transpiler-service#citation)."
+    "If you use any AI-powered feature from the Qiskit Transpiler Service in your research, use [the recommended citation](/docs/guides/qiskit-transpiler-service#citation)."
    ]
   }
  ],

diff --git a/docs/guides/algorithmiq-tem.ipynb b/docs/guides/algorithmiq-tem.ipynb
@@ -319,7 +319,7 @@
     "\n",
     "Name | Type | Description | Required | Default | Example\n",
     "-- | -- | -- | -- | -- | --\n",
-    "`pubs` | Iterable[EstimatorPubLike] | An iterable of PUB-like (primitive unified bloc) objects, such as tuples `(circuit, observables)` or `(circuit, observables, parameters, precision)`. See [Overview of PUBs](/docs/guides/primitive-input-output#overview-of-pubs) for more information. If a non-ISA circuit is passed, it will be transpiled with optimal settings. If an ISA circuit is passed, it will not be transpiled; in this case, the observable must be defined on the whole QPU. | Yes | N/A | (circuit, observables)\n",
+    "`pubs` | Iterable[EstimatorPubLike] | An iterable of PUB-like (primitive unified bloc) objects, such as tuples `(circuit, observables)` or `(circuit, observables, parameters, precision)`. See [Overview of PUBs](/docs/guides/pubs-broadcasting#pubs) for more information. If a non-ISA circuit is passed, it will be transpiled with optimal settings. If an ISA circuit is passed, it will not be transpiled; in this case, the observable must be defined on the whole QPU. | Yes | N/A | (circuit, observables)\n",
     "`backend_name` | str | Name of the backend to make the query.| No | If not provided, the least-busy backend will be used. | \"ibm_fez\"\n",
     "`options` | dict | Input options. See `Options` section for more details. | No | See `Options` section for more details.| \\{\"max_bond_dimension\": 100\\}\n",
     "\n",

diff --git a/docs/guides/build-noise-models.ipynb b/docs/guides/build-noise-models.ipynb
@@ -593,7 +593,7 @@
    "source": [
     "### Note on non-local qubit quantum error\n",
     "\n",
-    "`NoiseModel` does not support addition of non-local qubit quantum errors. They should be handled outside of `NoiseModel`. That suggests you should [write your own transpiler pass](./custom-transpiler-pass) (`TransformationPass`) and run the pass just before running the simulator if you need to insert your quantum errors into your circuit under your own conditions."
+    "`NoiseModel` does not support addition of non-local qubit quantum errors. They should be handled outside of `NoiseModel`. That suggests you should [write your own transpiler pass](/docs/guides/custom-transpiler-pass) (`TransformationPass`) and run the pass just before running the simulator if you need to insert your quantum errors into your circuit under your own conditions."
    ]
   },
   {
@@ -975,7 +975,7 @@
     "## Next steps\n",
     "\n",
     "<Admonition type=\"tip\" title=\"Recommendations\">\n",
-    "  - To simulate noisy circuits, see [Exact and noisy simulation with Qiskit Aer primitives](./simulate-with-qiskit-sdk-primitives).\n",
+    "  - To simulate noisy circuits, see [Exact and noisy simulation with Qiskit Aer primitives](/docs/guides/simulate-with-qiskit-sdk-primitives).\n",
     "  - Review the [Qiskit Aer noise module](https://qiskit.org/ecosystem/aer/apidocs/aer_noise.html) reference.\n",
     "</Admonition>"
    ]

diff --git a/docs/guides/circuit-library.ipynb b/docs/guides/circuit-library.ipynb
@@ -492,7 +492,7 @@
     "## Next steps\n",
     "\n",
     "<Admonition type=\"tip\" title=\"Recommendations\">\n",
-    "  -  Learn advanced methods for creating circuits in the [Construct circuits](./construct-circuits) topic.\n",
+    "  -  Learn advanced methods for creating circuits in the [Construct circuits](/docs/guides/construct-circuits) topic.\n",
     "  -  See an example of circuits being used in the [Grover's Algorithm](/docs/tutorials/grovers-algorithm) tutorial.\n",
     "  -  Review the [circuit library API](/docs/api/qiskit/circuit_library) reference.\n",
     "</Admonition>"

diff --git a/docs/guides/circuit-transpilation-settings.ipynb b/docs/guides/circuit-transpilation-settings.ipynb
@@ -289,7 +289,7 @@
    "source": [
     "## Step 3: Execute using Qiskit primitives\n",
     "\n",
-    "At this point, you have a list of circuits transpiled for the specified QPU. Next, create an instance of the sampler primitive and start a batched job using the context manager (`with ...:`), which automatically opens and closes the batch.\n",
+    "At this point, you have a list of circuits transpiled for the specified QPU. Next, create an instance of the Sampler primitive and start a batched job using the context manager (`with ...:`), which automatically opens and closes the batch.\n",
     "\n",
     "Within the context manager, sample the circuits and store the results to `result`."
    ]

diff --git a/docs/guides/cloud-setup-invited.mdx b/docs/guides/cloud-setup-invited.mdx
@@ -13,7 +13,7 @@ If you do not have an invitation from an administrator to join an account that a
 You can run workloads on IBM&reg; quantum processing units (QPUs) by setting up an account on IBM Cloud&reg;. You will also need to [install and set up Qiskit and Qiskit Runtime](/docs/guides/install-qiskit#local).
 
 
-Your user account is associated with one or more [instances](./instances), identified by _Cloud Resource Names_ (CRNs) that give access to IBM Quantum services. Additionally, a unique API token (also called a key) is assigned to each account, allowing for IBM Quantum access from Qiskit.  For instructions to choose a specific instance, see [Connect to an instance](./instances#connect-instance).
+Your user account is associated with one or more [instances](/docs/guides/instances), identified by _Cloud Resource Names_ (CRNs) that give access to IBM Quantum services. Additionally, a unique API token (also called a key) is assigned to each account, allowing for IBM Quantum access from Qiskit.  For instructions to choose a specific instance, see [Connect to an instance](/docs/guides/instances#connect-instance).
 
     <Admonition type="note">
       The [IBM Quantum Platform dashboard](https://quantum.cloud.ibm.com) and the [Instances page](https://quantum.cloud.ibm.com/instances) list the instances that you can access.

diff --git a/docs/guides/compute-services.mdx b/docs/guides/compute-services.mdx
@@ -8,7 +8,7 @@ In addition to the open-source tools of the Qiskit SDK, Qiskit addons, and other
 
 ## Qiskit Runtime
 
-Qiskit Runtime is the cloud-based service for executing quantum computations on IBM Quantum hardware. The `qiskit-ibm-runtime` package is a client for that service, and is the successor to the Qiskit IBM Provider. The Qiskit Runtime service streamlines quantum computations and provides optimal implementations of Qiskit primitives for IBM Quantum hardware. To get started with primitives, visit the [documentation](/docs/guides/get-started-with-primitives).
+Qiskit Runtime is the cloud-based service for executing quantum computations on IBM Quantum hardware. The `qiskit-ibm-runtime` package is a client for that service, and is the successor to the Qiskit IBM Provider. The Qiskit Runtime service streamlines quantum computations and provides optimal implementations of Qiskit primitives for IBM Quantum hardware. To get started with primitives, visit the [documentation](/docs/guides/primitives).
 
 Qiskit Runtime is designed to use additional classical and quantum compute resources, including techniques such as error suppression and error mitigation, to return a higher-quality result from executing quantum circuits on quantum processors. Examples include dynamical decoupling for error suppression, and readout mitigation and zero-noise extrapolation (ZNE) for error mitigation. Learn how to configure these options on the [Configure error mitigation](/docs/guides/configure-error-mitigation) page.
 

diff --git a/docs/guides/configure-error-mitigation.ipynb b/docs/guides/configure-error-mitigation.ipynb
@@ -200,8 +200,8 @@
     "You can turn on and off individual error mitigation and suppression methods, including dynamical decoupling, gate and measurement twirling, measurement error mitigation, PEC, and ZNE. See [Error mitigation and suppression techniques](error-mitigation-and-suppression-techniques) for an explanation of each.\n",
     "\n",
     "<Admonition type=\"note\" title=\"Notes\">\n",
-    "- Not all options are available for both primitives.   See the [available options table](runtime-options-overview#options-table) for the list of available options.\n",
-    "- Not all methods work together on all types of circuits.  See the [feature compatibility table](runtime-options-overview#options-compatibility-table) for details.\n",
+    "- Not all options are available for all primitives.   See each primitive's \"options\" page for its list of available options.\n",
+    "- Not all methods work together on all types of circuits.  See the feature compatibility table for [Estimator](estimator-options#options-compatibility-table) or [Sampler](sampler-options#options-compatibility-table) for details.\n",
     "</Admonition>\n",
     "\n",
     "<Tabs>\n",
@@ -246,15 +246,17 @@
     "\n",
     "## Turn off all error mitigation\n",
     "\n",
-    "For instructions to turn off all error mitigation, see the [Turn off all error suppression and mitigation](specify-runtime-options#no-error-mitigation) section.\n",
+    "For instructions to turn off all error mitigation when using Estimator, see the [Turn off all error suppression and mitigation](estimator-options#no-error-mitigation) section in the Estimator options guide.\n",
     "\n",
     "## Next steps\n",
     "\n",
     "<Admonition type=\"tip\" title=\"Recommendations\">\n",
     "  - Walk through an example that uses error mitigation in the [Cost function lesson](/learning/courses/variational-algorithm-design/cost-functions) in IBM Quantum Learning.\n",
-    "  - Learn more about [error mitigation and error suppression techniques](error-mitigation-and-suppression-techniques).\n",
-    "  - [Configure error suppression](configure-error-suppression).\n",
-    "  - Explore other [options](runtime-options-overview).\n",
+    "  - Learn more about [error mitigation and error suppression techniques.](error-mitigation-and-suppression-techniques)\n",
+    "  - [Configure error suppression.](configure-error-suppression)\n",
+    "  - Explore Sampler [options.](/docs/guides/sampler-options)\n",
+    "  - Explore Estimator [options.](/docs/guides/estimator-options)\n",
+    "  - Explore Executor [options.](/docs/guides/executor-options)\n",
     "  - Decide what [execution mode](execution-modes) to run your job in.\n",
     "</Admonition>"
    ]