Mood and tags

Mood and tags structure your journal beyond plain text: they capture how you felt and what the entry is about. Both are optional, editable while the entry is a draft, and shown in read mode and lists when set.

→ Create an entry · Journal overview

---

Where to manage them

Status	Where
Draft	Create → open entry → Edit entry → Mood and tags block
Published	No in-place edit in the Library: New version… → draft → mood / tags in the editor

Note

The pick lists (moods, tags) are Scripvio reference data, shown in your language from the app locale. The mobile app does not let you invent custom labels—you choose from the catalog.

---

Mood and tags block (editor)

Under Entry details, one card contains:

Area	Role
Mood card	One mood per entry (colored icon + label)
Tags row	Zero, one, or many tags (pills)

Mood card subtitle: tap to choose or change.

No mood: — instead of a label. No tags: — under Tags until you add some.

Each saved change triggers autosave (subtle indicator top-right of the block: spinner, check, error).

---

Mood

Open the sheet

1. In the editor, Mood and tags section.
2. Tap the Mood card (round avatar + Mood label).
3. The Mood sheet opens (drag handle at top).

Pick or clear

Action	Effect
Tap a list row	Mood applied; sheet closes; immediate save
Already active row	✓ checkmark on the right
Clear mood (first row, clear icon)	Removes mood; immediate save

Each mood shows:

• a colored avatar (from reference data);
• the label (e.g. gratitude, peace — translated);
• sometimes a technical code as subtitle (small gray text).

Order follows the server catalog (internal sort_order).

Only one mood

Unlike tags, you cannot combine two moods—each pick replaces the previous one.

Offline

Moods load over the internet (/reference/journal-moods). Offline, the list may be empty:

Reference data requires a connection.

→ Retry on Wi‑Fi or mobile data, then reopen Mood.

Tip

You can write Content offline and add mood later when online.

---

Tags

Open the sheet

1. Tap Manage tags (right of the Tags title).
2. The Tags sheet opens.

Sheet layout

Area	App label	Role
Top	Current selection	Pills for checked tags (or — if none)
Middle	Check or uncheck below.	FilterChip grid—one per catalog tag
Bottom	Submit	Saves selection and closes the sheet

Unlike mood, nothing is sent until you tap Submit. Closing without Submit discards changes made in the sheet.

Multiple selection

Action	Effect
Tap an unselected chip	Adds to selection (checkmark shown)
Tap a selected chip	Removes from selection
Submit	Saves the full tag code list

You may keep no tags (uncheck all, then Submit).

Offline

Same as mood: loaded via /reference/journal-tags. Empty offline → Reference data requires a connection.

---

Where mood and tags appear

In the editor (draft)

• Mood card: avatar + chosen label (or —).
• Tags area: colored pills with tag icon, or —.

In lists (Create → Journal, Library → Journal)

Item	Display
Mood	Chip with icon + label (when set)
Tags	Up to 3 pills on the list card; open the entry to see all
Draft	Draft chip as well

In read mode (Journal)

Below the title:

• Published chip (or Draft when previewing from the editor);
• mood chip (icon + label) when set;
• tag pills under Entry date;
• Updated line with timestamp.

---

Mood vs tags — when to use which

	Mood	Tags
Count	One only	Many
Meaning	Heart / moment feeling	Themes, contexts (family, service, study…)
Save	Immediate on tap	After Submit
Example	Gratitude, peace, discouraged	“Family”, “Prayer”, “Work”

They are independent: an entry may have only tags, only mood, both, or neither.

---

Connection and sync

Situation	Mood / tags
Online choice on server draft	Saved to account; visible on other devices after sync
Choice on local draft (local_…)	Stored locally; sent when syncing
Published entry	Mood / tags fixed in Library version until new version
Catalog unavailable	Connection message; no list to pick

Labels on a saved entry come from data stored on the entry (API label), even if the catalog changes later.

---

Quick flows (diagram)

flowchart TD
  A[Editor Mood and tags] --> B{Tap?}
  B -->|Mood card| C[Mood sheet]
  C --> D[Pick or Clear mood]
  D --> E[Autosave]
  B -->|Manage tags| F[Tags sheet]
  F --> G[Toggle chips]
  G --> H[Submit]
  H --> E

---

Current limits (mobile app)

Feature	Available?
Create personal mood / tag	No (Scripvio catalog)
Library filter menu by mood or tag	No — visual scan in lists + text search
Edit mood in Library read mode	No — use New version…
More than 3 tags on a list card	No — open entry to see all

---

Errors and messages

Message	Cause	Action
Reference data requires a connection.	Offline or empty API	Go online, reopen sheet
Error indicator on block	Mood / tags patch failed	Check network, retry choice
Empty mood list while online	Rare server issue	Retry later; write without mood

---

Good practices

Tip	Why
Set mood when finishing writing	More accurate feeling
Use about 2–4 tags	Easier to scan lists
Submit tags before leaving the sheet	Otherwise checks are not saved
Set mood / tags before publish	Library version is complete on first read

---

FAQ

Are moods the same for every user?
Yes—the catalog is shared; only your choices per entry are personal.

Can I change mood after publish without a new version?
Not in the Library. Use New version…, edit the draft, then Publish.

I checked tags but they do not show.
Did you tap Submit? Without it, the sheet closes without saving.

What is the gray code under a mood?
Stable server id; the label above is what you read in the UI.

Do tags replace the title?
No. Title / theme is still required to Publish; tags classify on top.

---

Next steps

Topic	Guide
Full creation flow	Create an entry
Publishing	Draft and publish
Tracking links	Reading, prayer, meditation