> For the complete documentation index, see [llms.txt](https://docs.jigx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jigx.com/examples/readme/actions/state-actions/set-state.md).
# set-state
The `set-state` action sets the global state (also called the solution state). Multiple components and jigs can access the state's value across the solution. Effectively managing the global state ensures that all parts of the app that depend on this data are updated consistently. To understand how to use states, see [State](https://docs.jigx.com/building-apps-with-jigx/logic/state).
## Configuration options
A `set-state` action can be set up in various ways:
1. As `onFocus` action that will be executed.
2. As `onRefresh` action that will be executed.
3. As the main action on the jig, and when you press the action, the `set-state` action will be executed.
4. The `onPress` and `onChange` actions will be executed when you trigger these events.
Some properties are common to all actions, see [Common action properties](/examples/readme/actions/common-action-properties.md) for the list of actions and their configuration options.
## Examples and code snippets
### set-state - solution state in onFocus/onRefresh
Count triggers with set-sate
Set state action is used when the onFocus/onRefresh event is triggered and a count is shown of the number of triggers.
See the example in [GitHub](https://github.com/jigx-com/jigx-samples/blob/main/quickstart/jigx-samples/jigs/jigx-actions/set-state/static-data/set-state-focus-refresh.jigx).
{% tabs %}
{% tab title="onFocus.jigx" %}
```yaml
onFocus:
type: action.set-state
options:
state: =@ctx.solution.state.onFocus-key
value: =@ctx.solution.state.on-focus-key +1
```
{% endtab %}
{% tab title="onRefresh.jigx" %}
```yaml
onRefresh:
type: action.set-state
options:
state: =@ctx.solution.state.onRefresh-key
value: =@ctx.solution.state.on-refresh-key +1
```
{% endtab %}
{% endtabs %}
### set-state as action
Set-state action
Set-state action is used as the primary action on the jig, to set the value of the action-key to +1.
See the example in [GitHub](https://github.com/jigx-com/jigx-samples/blob/main/quickstart/jigx-samples/jigs/jigx-actions/set-state/static-data/set-state-action.jigx).
{% code title="action.jigx" %}
```yaml
actions:
- children:
- type: action.set-state
options:
title: Add 1 to your action-key
state: =@ctx.solution.state.action-key
value: =@ctx.solution.state.action-key +1
```
{% endcode %}
### set-state - solution state in onPress/onChange
Set-state onPress/onChange
Set-state action used on the list as onPress/onChange action, to set the value of the key to +1.
See the example in [GitHub](https://github.com/jigx-com/jigx-samples/blob/main/quickstart/jigx-samples/jigs/jigx-actions/set-state/static-data/set-state-onpress-onchange.jigx).
{% tabs %}
{% tab title="onPress.jigx" %}
```yaml
onPress:
type: action.set-state
options:
state: =@ctx.solution.state.onPress-key
value: =@ctx.solution.state.on-press-key +1
```
{% endtab %}
{% tab title="onChange.jigx" %}
```yaml
onChange:
type: action.set-state
options:
state: =@ctx.solution.state.onChange-key
value: =@ctx.solution.state.on-change-key +1
::
::::
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.jigx.com/examples/readme/actions/state-actions/set-state.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
