> For the complete documentation index, see [llms.txt](https://docs.ixkio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ixkio.com/modules/locus.md).
# Locus
Locus is one of the most powerful ixkio features. Locus allows you to modify a wide range of tag properties and associated data using the ixkio mobile app. For example :
* Adding photos to tags
* Moving tags between locations
* Updating tag data with OCR (optical character recognition)
* Adding barcode or QR code data to tags
{% hint style="info" %}
Locus works after you have scanned a tag. Scan tag -> update data -> save.
{% endhint %}
## Using Locus
You need to install the ixkio mobile app and be either an Admin user or a Controlled User with Locus permissions in the user Group.
If enabled, tags can be scanned within the ixkio app using the Locus function to present editable data fields.
{% hint style="warning" %}
Locus data is not automatically updated. Any changes made to data on the Locus page need to be confirmed by the user tapping the 'Submit' button.
{% endhint %}
## Enabling Locus
*Active Folder Screen > Folder Function Panel > Locus Tab*
Locus is a module, so you first need to [activate the Locus module](/modules/adding-modules.md).
Locus is enabled at an Active Folder level to work on all tags in that folder tree. In the Active Folder screen, navigate to the Folder Function panel and select the Locus tab.
Then enable Locus.
## Locus Options
Locus allows you to display a range of Core and Extended Data associated with the Tag.
Each data element can be set to either just display or optionally allow edit. If you select Edit, you will also gain the additional Function Option :
#### Locus Functions
**None**\
None will show a simple form field box to allow manual entry via the phone keyboard.
**QR/Barcode**\
Underneath the form field box, there will also be a button to scan a QR Code or Barcode to populate the field. Tapping the button will launch the phone camera allowing a barcode scan. The form field will still be available for manual entry if required/preferred.
{% hint style="info" %}
Within the mobile app settings, you can select whether to confirm on a QR/Barcode scan. If you select confirm, the phone will prompt you to use a scanned barcode. If you disable this, then the phone will automatically populate the field with the barcode contents without further confirmation - for a faster interaction.
{% endhint %}
**OCR**\
OCR will enable the optical character recognition mode. This will provide a button under the field on Locus allowing the phone camera to read text. This can be ideal to copy printed serial numbers from products to be associated with a tag.
## Other Locus Settings
**Message**\
Message allows you to provide a simple additional instruction message to the Locus user.
**Submit Test**\
Modify the message on the Submit Button on the Locus page.
## Extended Image Option
This feature also requires the Extended Images module to be enabled.
If you have an [Extended Data](/features/meta-data/extended-data.md) image field, it's possible to enable this within Locus so that you can use the phone camera to take a photo and then have the photo automatically associated with a Tag.
To enable this, you just need to set 'Display and Edit' on your Extended Data Image field :
Note that 'Tag Level Image' in the example here will be the name of your Extended Data field. There's no additional Function. Selecting Display and Edit will allow the Locus user to take a photo and replace/upload an image for that Tag.
*(Coming July 2026)*
At the moment, the image resolution and quality is designed to allow fast upload but provide a reasonable quality of view on mobile screens.
From July 2026, we are also enabling user to set the quality of photos to allow for low network speeds or the requirement for higher quality images that may be viewed on desktops.
## Post Submit Actions
When the user taps the 'Submit' button on a Locus screen, you can additionally create a post-submit action :
**Move**\
A tag can be automatically moved to another Batch. This allows two further options :
* **Move on Batch Code** : This will move the tag to the Batch Code as specified by the user in the Batch Code field on the Locus page. You need to have made this field editable. \
\
As an example, if you set the Batch Codes *(Batch Screen > Batch Data Panel > Core Tab)* throughout your project, the user could scan a QR Code on a box of products to populate the Batch Code field in Locus. On submit, this would then automatically move the tag to that Batch within your project.
* **Move to Batch Code** : This gives you another field where you can enter a specific fixed Batch Code to move the submitted tag to.
**Assignment**\
You can optionally also set the Assigned flag on submit. Useful if you are also moving the Tag to another Batch, you may also want to mark it as being Assigned.
## Locus Only Users
*(From July 2026)*
You may want to some users to use the ixkio mobile app but only have access to the Locus screen. This is possible by changing the settings for a Controlled User Group.
When the user logs into the ixkio mobile app, they will not see the Assign/Encode/Check options and will go immediately to the Locus screen.
## Locus Deep Linking
*(From July 2026)*
It's possible to encode your NFC tags so that they will launch the ixkio mobile app directly into the Locus screen. This allows users to access Locus quicker rather than having to open the app first. Note :
* Tags must be specifically encoded for this action. Any existing tags or tags encoded with the standard ixkio structure will not 'deep link' into the app.
* Deep linking only works on the ixkio domain. If you have a custom domain, you cannot deep link into Locus.
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.ixkio.com/modules/locus.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.