Element Themes

Element Themes

An Element Theme gives a story's tables and interactive elements a consistent visual style. It belongs to the whole story, so authors choose it once rather than styling every chapter separately.

Choose a theme

The Owner can open Edit Story and find Element Theme. Choose one of the displayed theme cards, then select Save Story.

CHYOA Default is used when no other theme has been selected.

What the theme changes

The selected theme styles special story elements wherever they appear:

• Markdown tables in chapter prose;
• reader customization fields, including {input reader:name};
• Game State rows, progress displays, and inventory;
• {stat ...} and {meter ...} displays;
• dice rolls and their results;
• reveal and action buttons;
• code locks and their answer fields;
• chapter polls and poll results;
• chat bubbles.

Changing the theme updates these elements in existing as well as future chapters. Authors do not need to rewrite the table or chapter syntax.

What the theme does not change

An Element Theme does not change:

• ordinary chapter prose and headings;
• story or chapter titles;
• the story cover;
• follow-up branch layout;
• comments;
• the site header, Library, search, or other CHYOA pages;
• what a variable, poll, roll, reveal, lock, or action does.

It changes presentation, not story logic or saved reader choices.

Element Theme versus site appearance

Every reader can independently choose the site's White, Black, or Sepia appearance. That choice controls the surrounding CHYOA page. The story's Element Theme controls its special story elements inside that page.

The combinations work together. For example, Adventure Parchment remains the story's theme when one reader uses White and another uses Black, but its colors adapt so the controls remain readable in both appearances.

Changing your own site appearance does not change the Element Theme saved by the story Owner. Changing the story's Element Theme does not change a reader's White, Black, or Sepia preference.

Tables follow the story theme

Tables are part of the Element Theme even when they contain no interactive syntax. For example:

The theme changes the table panel, headings, text, and dividers. Wide tables still scroll horizontally on narrow screens. Theme styling cannot make an overly large table easy to understand, so keep columns concise.

Choose a theme for the story, not one scene

Because the setting is story-wide, choose a design that remains suitable across different chapters and interactions. A dramatic theme may look excellent for one scene but become distracting if every short poll or reader input uses it.

Consider:

• the story's genre and tone;
• how often special elements appear;
• whether tables contain a lot of information;
• whether readers need to compare stats or poll options quickly;
• how the strongest accent colors feel across a long reading session.

The theme cards show their basic palette. Save the story and view a representative chapter to judge the complete controls.

Preview all important elements

When a story uses several features, create or open a draft chapter that includes representative examples:

View the chapter in White, Black, and Sepia appearance. Pay particular attention to text contrast, field boundaries, selected choices, disabled controls, long labels, and table dividers.

Change a theme safely

You can change an established story's Element Theme without changing its chapters. Before saving a new choice:

1. identify chapters with tables or interactive elements;
2. view at least one busy chapter in each site appearance;
3. test controls as well as their resting appearance;
4. check narrow screens for tables, polls, and long labels;
5. keep the new choice only if it works throughout the story.

If a special element does not change with the theme, first confirm that it is one of the supported elements listed above and that the story change was saved. Ordinary prose and general CHYOA controls intentionally keep the site appearance instead.

Related Guide chapters

• Create and Publish a Story
• Formatting, Images, Links, and Tables
• Polls and Interactive Blocks
• Showing Reader and Game Values
• Random Values, Rolls, Reveals, and Actions