# Creating and editing notes

## Creating a new note from Unity

To create a new Note, focus on the spot in the scene where you want to create it, and click the Plus button. The newly created card will be immediately sent to the Codecks server, and you can keep editing its properties in the Inspector.

<figure><img src="/files/R6zW3CQv1yIpTaRPcu1m" alt="" width="563"><figcaption><p>Click the Plus button to create a new note</p></figcaption></figure>

{% hint style="info" %}
The new Scene Note will go in the default Deck specified during setup, and will be associated with the scene that is the currently Active scene. You can always change these later.
{% endhint %}

## Editing a note

You can edit the data of a Scene Note by just clicking on its icon, and editing the data in the Inspector.

However, when you are done, you need to **press the Save button** at the bottom to upload the changes to the Codecks server.

<figure><img src="/files/jyqzaz7V4G2meYeplYLg" alt="" width="375"><figcaption><p>A Scene Note being edited, displaying the Save button at the bottom</p></figcaption></figure>

{% hint style="danger" %}
Any unsaved change will be lost next time Codecks Scene Notes loads data, so make sure you save as soon as you're done editing.
{% endhint %}

## Note properties

### Note state

All notes have a state, which by default is "Not started". The state is reflected in the coloured bar at the top of the note's Inspector. You can change a note's state by just clicking the buttons under the bar.

<figure><img src="/files/KpUYRptl0bwvGhNe7cIt" alt="" width="375"><figcaption><p>An unstarted note</p></figcaption></figure>

<figure><img src="/files/3ZUi8eVgEH24UyBulilh" alt="" width="375"><figcaption><p>A completed note</p></figcaption></figure>

The possible states are:

* Not started: grey bar
* Started: blue bar
* Done: green bar

The meaning that you give to each status is up to you and your team.

{% hint style="info" %}
If a note is a **Doc** note in Codecks, the bar will be yellow and some properties will not be available.
{% endhint %}

### Title

The title of the note.

### Contents

The main text of a note.

### Deck

The deck that contains the note in Codecks. Can be used for [filtering](/codecks-scene-notes/organising-notes/filtering-notes.md#filtering-notes-by-deck).

### Scene

You can freely reassign a different scene to the **Scene** field.

{% hint style="info" %}
Keep in mind that reassigning a scene might make the note disappear from the Scene View if the specific scene is not currently loaded.
{% endhint %}

### Linked GameObject

If a note is not linked to any object, it's just placed with a **World position** in the scene, and you can edit it here.

<figure><img src="/files/4GF6JsHABExMnouXoSnX" alt="" width="563"><figcaption><p>The Scene information section of a note</p></figcaption></figure>

If a GameObject is dragged into the **Linked to** field, the note becomes linked to that GameObject. When that object moves or rotates, the note moves with it. As such, while the note still has a world position, this will not be editable: what matters is the **Local offset**, which can be tweaked at the bottom of this section:

<figure><img src="/files/5cz1zM8suuIIBK2AHxdr" alt="" width="563"><figcaption><p>This note is linked to a GameObject</p></figcaption></figure>

{% hint style="info" %}
Deleting the GameObject linked doesn't delete the note, it just unlinks it.
{% endhint %}

### Priority

The priority of the card in Codecks.

### Effort

The priority of the card in Codecks.

### Owner

The owner of the card in Codecks. This can be used for [filtering](/codecks-scene-notes/organising-notes/filtering-notes.md#filtering-notes-by-owner) too.

You can also enforce more safety by disallowing users from editing notes that are not assigned to them. See the setting **Lock Notes You Don't Own** in [Project Settings](/codecks-scene-notes/other/project-settings.md).

## Deleting a note

Like in Codecks, we don’t allow full deletion of a Scene Note. To remove a Note, you need to archive it.

Click on the Archive button in the note’s Inspector, and it will immediately be archived on the Codecks website as well (no need to save).

<figure><img src="/files/2DZWFLbThzWw2hvEnCDL" alt="" width="317"><figcaption><p>Click on the Archive button to archive the note</p></figcaption></figure>

You can bring it back, by unarchiving it on the Codecks site (this requires reloading data in Unity).

{% hint style="warning" %}
If you just delete the GameObject that displays a note (by hitting Ctrl + Delete, for instance), the corresponding note is not deleted on the Codecks server. You need to archive it.
{% endhint %}


---

# Agent Instructions: 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://tools.continis.io/codecks-scene-notes/using-the-tool/creating-and-editing-notes.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.
