# system.db.runNamedQuery is showing as This function is deprecated and will be hidden in the future In Ignition 8.3

**URL:** <https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204>\
**Category:** Ignition\
**Tags:** ignition83\
**Created:** [February 26, 2026, 3:06pm UTC](https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204 "2026-02-26T15:06:35Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![samis](https://avatars.discourse-cdn.com/v4/letter/s/ac91a4/32.png) [@samis](https://forum.inductiveautomation.com/u/samis)\
**Post date:** [February 26, 2026, 3:06pm UTC](https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204/1 "2026-02-26T15:06:35Z")

</div>

Hi,

I am using Ignition version 8.1 and we are planning to update to Ignition 8.3 but when i updated my dev environment to ignition 8.3 i am seeing below message for system.db.runNamedQuery that it will be hidden in future. Eventhough the function works ok now in my dev environment with Ignition 8.3. Can you please help me with below questions:

1. I have already used this function at many places i my current development. Can you please let me know if this going forward in 8.3 this function is just hidden and will always work or its going to be removed later on?
2. I have also tried to use system.db.execQuery instead of system.db.runNamedQuery in my further developments but when i moved the code to my prod which is still 8.1 version this new function system.db.execQuery dosen’t seems to work.

How should i manage my environment now so that it won’t break and always be ready for new updates?

### runNamedQuery([project], path, [parameters], ...): any

#### Method on system.db

**⚠ Deprecated ⚠:** This function is deprecated and will be hidden in the future.

**Replace with:** `system.db.execQuery, system.db.execUpdate`

---

<div class="post-metadata">

**Author:** ![dkhayes117](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/dkhayes117/32/68344_2.png) [@dkhayes117](https://forum.inductiveautomation.com/u/dkhayes117)\
**Post date:** [February 26, 2026, 3:24pm UTC](https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204/2 "2026-02-26T15:24:05Z")

</div>

IA hides deprecated functions to stop future use, but they usually remain in the code, so projects are not broken.

It would be worthwhile to convert all of your `runNamedQuery` calls to the new version as you can. A big bonus is in a lot of scripts you have to determine the calling scope with the old version, this can be removed with the new functions.

Example

```python
# determines if you must provide the project name or not.  
# the new functions have the project name as optional and will not require this logic
if isGateway:
    system.db.runNamedQuery('global', queryName,{})
else:
    system.db.runNamedQuery(queryName,{})

```

---

<div class="post-metadata">

**Author:** ![paul-griffith](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/paul-griffith/32/37249_2.png) [@paul-griffith](https://forum.inductiveautomation.com/u/paul-griffith)\
**Post date:** [February 26, 2026, 5:07pm UTC](https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204/3 "2026-02-26T17:07:26Z")

</div>

More on deprecation here:

> [@8.3 Transformation performance in Vision client](https://forum.inductiveautomation.com/t/8-3-transformation-performance-in-vision-client/110975/3):
>
> In 8.3: The non-"prep" variants of direct SQL query functions (runQuery, runScalarQuery, runUpdateQuery) are deprecated in all scopes, because they're strictly worse than the prep variants - there's literally no reason to use them. The runNamedQuery and runSFNamedQuery functions are deprecated in all scopes because: It had a fundamental signature incompatibility between client and gateway scope with the project parameter The idea of a single named query function issuing any kind of query (que…

---

<div class="post-metadata">

**Author:** ![samis](https://avatars.discourse-cdn.com/v4/letter/s/ac91a4/32.png) [@samis](https://forum.inductiveautomation.com/u/samis)\
**Post date:** [February 27, 2026, 1:00pm UTC](https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204/4 "2026-02-27T13:00:43Z")

</div>

So now i have to change all my runNamedQuery to execQuery. It is a lot of change as i have used in many scripts, events bindings e.t.c….but i think i have no other choice and have to do it as runNamedQuery still works in 8.3 but IA might remove it completely in other upcoming major version and my whole project will always have a risk of getting break.

---

<div class="post-metadata">

**Author:** ![dkhayes117](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/dkhayes117/32/68344_2.png) [@dkhayes117](https://forum.inductiveautomation.com/u/dkhayes117)\
**Post date:** [February 27, 2026, 1:13pm UTC](https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204/5 "2026-02-27T13:13:14Z")

</div>

Use the Find/Replace function to speed up the conversion, but IA is not going to just pull the rug out from under you. (Note that this is the benefit of delegating all events scripts etc. to project scripts, it makes it easier to make these kinds of changes.)

Even if another major release deprecates the old function, you don't have to update until you are ready. My guess would be a couple years minimum before it would happen via v8.5.

---

<div class="post-metadata">

**Author:** ![paul-griffith](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/paul-griffith/32/37249_2.png) [@paul-griffith](https://forum.inductiveautomation.com/u/paul-griffith)\
**Post date:** [February 27, 2026, 4:51pm UTC](https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204/6 "2026-02-27T16:51:38Z")

</div>

Just going to highlight this portion of my other post.

> [@8.3 Transformation performance in Vision client](https://forum.inductiveautomation.com/t/8-3-transformation-performance-in-vision-client/110975/3):
>
> All that said - as ever, just because a function is deprecated does not mean it is going to **break** , now or in the immediate future. With **literally one exception** in the last decade, we do not remove scripting functions after they've been added. Eventually they **may** functionally stop doing anything (e.g. the `system.alert` functions, originally deprecated in 7.6 / **2013** , stopped doing anything in 8.3), but they will not be removed, and in the unlikely event we can't provide equivalent functionality automatically, it will be clearly marked in the upgrade guide.

There's not going to be a rug pull. While I'd recommend moving to the new functions _eventually_, it's because they are **better**. There is absolutely no urgency to doing so.

I'll even state confidently:  
The next major version of Ignition, 2027.2, is not going to do anything to change the behavior of `system.db.runNamedQuery` in a backwards-incompatible way.

---

<div class="post-metadata">

**Author:** ![samis](https://avatars.discourse-cdn.com/v4/letter/s/ac91a4/32.png) [@samis](https://forum.inductiveautomation.com/u/samis)\
**Post date:** [March 3, 2026, 8:05am UTC](https://forum.inductiveautomation.com/t/system-db-runnamedquery-is-showing-as-this-function-is-deprecated-and-will-be-hidden-in-the-future-in-ignition-8-3/114204/7 "2026-03-03T08:05:58Z")

</div>

Thank you for the responses. I will slowly try to move the code to the new version now 🙂
