← All help

Properties

Click + on the Properties heading in the left panel to add a property, a fact you can record on any node in the project.

Where: Space Studio › Left panel › Properties (to define) · Right panel › Properties (to fill in)

What it is

Notes are for what you'd tell someone. Properties are for what you'd put in a column: an owner, a status, a cost, a renewal date, anything you'd want to read off twenty nodes at a glance. They're optional, and plenty of projects never use one.

The list belongs to the project, not to a classification. Define a property once and it's available on every node. Defining "Owner" doesn't force an owner on to anything; it just means the box is there when you want it. A property you leave empty isn't written to the file at all.

How to use it

Adding one

Open the Properties section (it starts closed) and click + (Add a property).

  • Name is what you'll see, in normal words: "Renewal date", not "renewal_date".
  • Kind decides the control you get and how the value is written down:
KindWhat it's for
TextA line of writing, anything that doesn't fit the others
NumberA figure you might compare or total
Yes / NoA switch
DateA day, picked from a calendar
ChoiceOne option from a list you set
TagsSeveral options from a list you set
LinkA web address, opens in your browser
EmailAn email address, opens your mail app
PhoneA phone number
Rating out of 3Three stars, for a rough call
Rating out of 5Five stars, for a finer one
KeyA long value you copy rather than read, see below

Choice and Tags ask for their options. Add more later from any node and they join the list for everyone.

Filling one in

Open a node and look at Properties in the Right Panel. Every property the project defines is listed, filled in or not, so it reads as a form. A value saves when you press [Enter] or click away, or the moment you click a switch, a star or an option, and it's undoable. Clear a value and the row stays, empty.

Renaming and changing the Kind

Click a property in the left panel to edit it. Renaming changes only the label: each property keeps a permanent short key underneath, and that's what your files hold, so a rename never touches a node or loses a value. Changing the Kind keeps the values you've entered, so after switching Text to Choice, tidy any value that isn't in the option list yet, or add it as an option.

Removing

Remove in the property's editor takes it out of the project, and asks first. It deletes nothing: the property disappears from nodes you'd left empty, and where you'd filled it in the value stays, with a small × beside it. Put the property back and everything returns to normal. That × appears only on a property the project doesn't define (a removed one, or one typed into the file by hand or by an AI), and clicking it clears the value from that node alone.

Key, and what "hidden" means

Key is for things you paste rather than read: an API key, a licence code, a long identifier. It's masked until you reveal it, copies in one click, and is left out of Filamental's search. The eye-and-slash mark means hidden, nothing more.

It isn't encrypted. Nothing in a Filamental project is: the value sits in your Markdown file as ordinary text, readable by anyone who can open the folder. Anything that would hurt you if read belongs in a password manager.

Tips

  • Properties sit in the frontmatter at the top of each node's file, as plain text whatever the Kind, so the file stays readable and hand-editable. See How Your Files Are Stored.
  • Properties aren't included in a shared link or a published page.
  • An AI connected to your project reads properties as named facts, Key values included, so don't put anything there you wouldn't hand it. See Connect an AI App.

How this helps you

  • Use properties for anything you'll compare across nodes, such as what's blocked.
  • Use Choice and Tags to keep values consistent, so "In progress" doesn't drift into "in-progress".

Related

Still stuck? Email [email protected].