# Story Elements

## What are story elements?

Story elements are the building blocks of any narrative. They represent characters, locations, items, species, and other components that shape your universe. Each element stores the details you need to keep your story consistent and organized.

## General

Writing a story is like laying out a jigsaw puzzle. You have characters, locations, items, and many more background puzzle pieces. In Fortelling, we call these items story elements. Every type of story element has a separate tool within the app. Each tool has a few default blocks, out of which the tool consists: data attributes, images, notes, and labels.

## Attributes

With our default attributes, Fortelling tries to cover various genres and approaches to organizing your thoughts. You can also use the extensive lists as a source of inspiration. You can add multi-line texts for more extensive answers. Your attributes will be listed on the story element's page in a collapsible. If there is no data for a category, it will be hidden.

## Custom fields

Fortelling offers a wide range of default attribute fields for each type of story element. However, we can't cover everything. You can add your own fields in the custom fields category. Read more on the custom tools page for more customization options.

{% content-ref url="/pages/5oBy3GrlPvzOoqptbxBx" %}
[Custom Tools](/story-elements/custom-tools.md)
{% endcontent-ref %}

## Images

There are two types of images you can connect to a story element:

1. **Main image**: this image will represent this story element throughout the app. It will be used in lists, at the top of the element's page, and as the main image on pinboards.
2. **General image**: you can add multiple images to this carrousel. It only shows on the story element's page. Use this to create a mood board for your character.

Images can be added from your image gallery, by uploading a new image or searching the online library of [Pexels](https://www.pexels.com).

## Notes

If you need to attach more text to a story element, link a note. You can use the rich text editor to structure your text more organized. 

{% content-ref url="/pages/K9s58LsuYmfy7q1sl01n" %}
[Files](/organization/files.md)
{% endcontent-ref %}

## Labels

Use labels to tag story elements and cluster them together. Each tool allows you to filter, on a specific label.

{% content-ref url="/pages/CTyYpp7wEoBUjgvL9s9r" %}
[Labels](/organization/labels.md)
{% endcontent-ref %}

## Interactive tutorial

Please ensure your audio is turned on for the optimal experience.

{% @arcade/embed flowId="NzelrcqdTHoa8rYObpci" url="<https://app.arcade.software/share/NzelrcqdTHoa8rYObpci>" %}


---

# 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://wiki.fortelling.app/story-elements/story-elements.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.