> For the complete documentation index, see [llms.txt](https://brightwind.gitbook.io/brighthub-user-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brightwind.gitbook.io/brighthub-user-docs/reference-user-manual/setup-tab/guide-to-editing-station-metadata.md).

# Guide to Editing Station Metadata

Here is a practical guide to editing the station metadata on BrightHub:

**Information Icon**\
Note that you can hover over the information symbol for a description of what metadata should be entered into each field on BrightHub.

![](/files/xeK7vOO4PEV73c7GfoS5)\
\
**Text Colours**\
The colour of fields on BrightHub changes according to whether changes have been made and/or saved.

* *Temporarily changed* edits appear in green <br>

  <figure><img src="/files/0LtNBPcgIopFqIMIyl8H" alt=""><figcaption></figcaption></figure>
* *Permanently saved* changes appear in black. To ensure changes are permanently saved, click on the green save button (top right corner). <br>

  <figure><img src="/files/JcwgFx3ABYLtIMQq7IkJ" alt=""><figcaption></figcaption></figure>
* *Incompatible changes* appear in red text. In order to permanently save changes, any incompatible changes in red text must be corrected or reverted. <br>

  <figure><img src="/files/tuGq25xJ96Sy5f2xLi07" alt=""><figcaption></figcaption></figure>
* *File changes* appear in orange text when BrightHub detects changes in the metadata from ingested data files. \
  \
  You can click on the green save button to permanently save changes detected from files - this causes the text to turn black.

  <figure><img src="/files/Wafuj4xreWdmUUSGa9FN" alt=""><figcaption></figcaption></figure>

**Saving changes**\
There are two save buttons on BrightHub.

* The *apply changes* icon is used to save changes to a row on BrightHub.\
  ![](/files/ODEqheDd5tZ5ig4590dQ)
* The green *save* button on the top right is used to save all changes permanently.

![](/files/Nk9bYCUsqOxk3KdFKa46)\
\
Tables on BrightHub contain the fields 'Updated at UTC' and 'Updated By' which store the time that a row within a table was last modified and the BrightHub user responsible for making the changes - this ensures traceability of the metadata.

**Cancelling Changes**\
Similarly, there are multiple methods of reverting changes on BrightHub:

* The small 'x' is used to *Exit Edit Mode* for a particular row and will revert any unsaved changes within that row.\
  ![](/files/S1lIH6B2NXtIJPxIAlYf)
* The 'Delete' icon is used to delete an entire row from a table:

![](/files/o40TgspfNO1j7WrbFVWG)

* The large grey *Exit Edit Mode* icon on the top right is used to revert all changes across all tabs and tables permanently:\
  ![](/files/6LCqQeV3BaOUo0u07BAM)\
  This prompts users to ask whether to save changes before exiting:\
  ![](/files/9JpcJKtJrpndVKHinvOZ)\
  If you hit *Don't Save*, then all unsaved changes will be reverted as you exit edit mode.

**How to Edit a Field**\
To edit a field in an existing table on BrightHub:

1. Click on the edit icon\
   ![](/files/K4XgVJHrJuw3tcSN9Rim)\
   Alternatively you can double click on the field you would like to edit.
2. Once in edit mode, select a field by clicking on it. ![](/files/ODEqheDd5tZ5ig4590dQ)
3. Complete the field by typing or selecting from the drop-down menu. You can either type or select from the calendar in the case of dates&#x20;
4. Once you have edited a row within a table, click on apply changes to save changes to that row ![](/files/ODEqheDd5tZ5ig4590dQ)\
   \
   or the 'X' to cancel changes to the row and exit edit mode for that row. ![](/files/S1lIH6B2NXtIJPxIAlYf)<br>
5. To delete a row from a table on BrightHub, click the delete icon ![](/files/o40TgspfNO1j7WrbFVWG)
6. To add a new row to a table on BrightHub, use the add button above the table on the right, for example, the 'Add Measurement' button on the measurement tab or the 'Add Config' button on the logger main configs tab\
   ![](/files/tRDvvAY05v8UUEmNM2oS)\
   Fill in the fields in the new row as described above.

**Error Saving Changes**\
BrightHub may raise an error when the green save button in the top right corner is clicked, for example if invalid changes have been made to logger config dates. In this scenario the changes may need to be reverted by hitting the large grey Exit Edit Mode icon on the top right, as BrightHub will not allow changes to be saved until the error is fixed.

Note that certain configurations extracted by BrightHub from ingested logger files cannot be edited on the BrightHub UI. If you are unable to edit a field of the metadata on BrightHub which you believe is invalid, please contact <support@brighthub.io> for further information.


---

# 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://brightwind.gitbook.io/brighthub-user-docs/reference-user-manual/setup-tab/guide-to-editing-station-metadata.md?ask=<question>
```

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.
