Operations Reference
Complete reference for all 100+ text transformation operations available in BotWash. Operations are organized by category and can be combined in formulas.
Overview
Each operation transforms text in a specific way. Operations have configurable parameters that control their behavior. When you create a formula, you stack operations in order - they execute sequentially from top to bottom.
Structure & Flow
Control how text is organized, broken into paragraphs, and structured.
sentence_splitter
Splits long sentences into shorter ones based on a maximum length.
max_len- Maximum sentence length in words
sentence_merger
Combines short sentences when they are closely related.
min_len- Minimum length to trigger mergingcohesion_threshold- How related sentences must be (0-1)
sentence_variance_optimizer
Optimizes sentence length variance for more natural-sounding text.
target_variance- Target variance level (optional)preserve_short- Preserve intentionally short sentences (optional)
paragraph_rechunker
Reorganizes text into paragraphs of target length.
target_lines_per_para- Target paragraph sizemax_para_len- Maximum paragraph length in lines
listifier
Converts text into bulleted or numbered lists.
max_items- Maximum list items to createkeep_sentences- Preserve sentence structure
delistifier
Converts lists back into prose paragraphs.
joiner_style- Style of connection (narrative/technical)
list_sorter
Sorts list items alphabetically, numerically, or by length.
order- Sort order (alpha/numeric/length)direction- Direction (asc/desc)
heading_normalizer
Fixes heading hierarchy and levels.
start_level- Starting heading levelfix_hierarchy- Auto-fix broken hierarchy
line_wrapper
Wraps long lines at specified width.
max_width- Maximum line width in charactersbreak_words- Allow breaking words mid-word
quote_formatter
Formats quotes as blockquotes or inline.
style- Quote style (blockquote/inline)attribution_format- How to format attribution
table_normalizer
Normalizes table formatting and alignment.
align_columns- Align table columnspadding- Cell padding amount
section_numbering
Adds or removes section numbers.
action- Add or remove numbersformat- Numbering format (1.1/I.A/(1))
footnote_organizer
Organizes and formats footnotes.
style- Footnote style (numeric/symbolic)placement- Where to place footnotes (bottom/inline)
toc_generator
Generates a table of contents from headings.
max_depth- Maximum heading depthinclude_numbers- Include section numbers
Tone & Style
Adjust the voice, formality, and emotional tone of text.
hedge_reducer
Removes hedge words like "maybe", "perhaps", "possibly".
level- How many hedges to remove (0-10)keep_politeness- Preserve polite hedgesprobability- Probability of removal (0-1, optional)
formality_tuner
Comprehensively adjusts formality level with 140+ transformations. Formal mode converts casual language to professional (80+ patterns including greetings, slang, phrasal verbs, intensifiers). Casual mode makes formal text more conversational (60+ patterns).
level- Target formality (casual/formal)
empathy_injector
Adds empathetic language and understanding.
intensity- How much empathy to add (0-10)avoid_patronizing- Avoid sounding condescending
assertiveness_tuner
Makes text more or less assertive.
direction- More or less assertivelevel- Amount of change (0-10)
humor_spritz
Adds personality and humor through 100+ transformations across 4 levels. Level 0.3: playful transitions. Level 0.5: conversational expressions. Level 0.7: idioms and personality. Level 0.8: dramatic flair. Level 0.9: technical puns (if enabled).
subtlety- Humor intensity level (0-1, where 1 is most humorous)ban_puns- Disable technical wordplay and puns
sentiment_shifter
Adjusts emotional tone toward positive, negative, or neutral.
target- Target sentiment (positive/negative/neutral)intensity- Strength of shift (0-10)
gender_neutralizer
Makes language gender-neutral by replacing gendered job titles and terms (chairman→chairperson, fireman→firefighter, etc.) plus pronoun handling. Includes 15+ gendered term replacements applied to all strategies.
strategy- Pronoun strategy (they: replace with they/them/their, plural: no pronoun changes, omit: remove pronouns)
voice_normalizer
Normalizes to first, second, or third person.
target- Target perspective (1p/2p/3p)
question_converter
Converts statements to questions or vice versa.
mode- Direction (to_questions/to_statements)
exclamation_normalizer
Normalizes excessive exclamation marks.
max_consecutive- Maximum consecutive marks allowedreplacement- What to replace with
rhetorical_enhancer
Adds 11 rhetorical devices for persuasive writing: question (rhetorical questions), anaphora (repetition at beginning), tricolon (rule of three), parallelism, alliteration, hyperbole, antithesis (contrasting ideas), epistrophe (repetition at end), repetition (emphasis), metaphor, amplification (building crescendo).
devices- Array of device names to apply (e.g., ['question', 'hyperbole', 'metaphor'])frequency- Application probability (0-1, where 1 always applies)
Clarity & Simplicity
Make text clearer, more concise, and easier to understand.
active_voice_enforcer
Converts passive voice to active voice.
aggressiveness- How aggressively to convert (0-10)
readability_normalizer
Adjusts text to target reading grade level.
target_grade- Target grade level (1-20)
jargon_translator
Replaces jargon with plain language.
domain- Industry/domain (optional)keep_glossary- Maintain glossary of terms
conciseness_tuner
Reduces word count while preserving meaning.
shrink_percent- Target reduction percentage
redundancy_pruner
Removes redundant phrases and repetitive content.
strictness- How strict to be (0-10)
plural_fixer
Fixes incorrect singular/plural forms.
aggressiveness- Confidence threshold (0-10)
synonym_simplifier
Replaces complex words with simpler synonyms.
target_grade- Target reading levelprobability- Probability of replacement (0-1, optional)
acronym_expander
Expands acronyms on first use.
expand_first_only- Only expand first occurrencecustom_items- Custom acronym definitions (optional)
duplicate_remover
Removes duplicate or near-duplicate sentences.
min_length- Minimum sentence length to checksimilarity_threshold- Similarity threshold (0-1)
transition_adder
Adds transition words between sentences/paragraphs.
frequency- How often to add transitionstypes- Types of transitions to use
word_frequency_filter
Reduces overuse of specific words.
max_frequency- Maximum word occurrence countexceptions- Words to ignore
Find & Replace
Pattern matching, character manipulation, and text substitution.
custom_replacer
Simple find and replace.
find- Text to findreplace- Replacement textcase_sensitive- Case-sensitive matching
regex_replacer
Advanced pattern matching with regular expressions.
pattern- Regular expression patternreplacement- Replacement stringflags- Regex flags (g, i, m, etc.)
emoji_remover
Removes or filters emojis.
mode- Remove all or selectkeep_list- Emojis to keep (optional)
special_char_remover
Removes or keeps specific special characters.
chars- Characters to processmode- Remove or keep specified chars
unicode_normalizer
Normalizes Unicode characters.
target- Target format (ascii/nfc/nfd)
whitespace_controller
Normalizes whitespace and tabs.
tabs_to_spaces- Convert tabs to spacesspaces_per_tab- Spaces per tabtrim_lines- Trim line ends
character_filter
Filters characters by type.
keep- What to keep (letters/numbers/alphanumeric/custom)custom_chars- Custom character set (optional)
line_deduplicator
Removes duplicate lines.
case_sensitive- Case-sensitive comparisontrim_before_compare- Trim before comparing
prefix_suffix_manager
Adds or removes prefixes/suffixes.
action- Add or removetype- Prefix or suffixtext- Text to add/remove
Polish & Correctness
Fix grammar, spelling, punctuation, and formatting.
spell_checker
Checks and optionally fixes spelling errors.
auto_fix- Automatically fix errorsdictionary- Dictionary variant (us/uk)
grammar_fixer
Fixes common grammar errors.
rules- Grammar rules to applyaggressiveness- Confidence threshold (0-10)
punctuation_sanity
Normalizes punctuation style.
oxford_comma- Use Oxford commadash_style- Em dash or en dash
quote_smartener
Converts straight quotes to smart quotes.
style- Quote style (smart/straight/guillemets)
contraction_manager
Expands or contracts words.
mode- Expand or contractprobability- Probability of conversion (0-1, optional)custom_items- Custom contractions (optional)
capitalization_style
Normalizes capitalization.
mode- Style (title/sentence/apa_title)
tense_normalizer
Normalizes verb tenses.
tense- Target tense (present/past)
person_perspective_normalizer
Normalizes grammatical person.
person- Target person (1p/2p/3p)
quote_attribution_clarity
Ensures quotes are properly attributed.
enforce_attribution- Require attribution for all quotes
terminology_consistency
Ensures consistent term usage.
glossary- Term mapping dictionary
number_formatter
Formats numbers with commas and rules.
spell_out_below- Spell out numbers below this (optional)use_commas- Use comma separators (optional)format- Number format style (optional)locale- Locale for formatting (optional)
date_formatter
Formats dates consistently.
format- Format style (iso/us/eu/relative)
url_validator
Validates and fixes URLs.
fix_common_errors- Auto-fix common mistakesrequire_protocol- Require http/httpsvalidate_only- Only validate, don't fix (optional)
email_validator
Validates and fixes email addresses.
fix_common_errors- Auto-fix common mistakesvalidate_only- Only validate, don't fix (optional)normalize- Normalize email format (optional)
apostrophe_fixer
Fixes incorrect apostrophe usage.
fix_possessives- Fix possessive formsfix_contractions- Fix contractions
comma_splice_fixer
Fixes comma splice errors.
strategy- How to fix (period/semicolon/conjunction)
dash_remover
Handles dashes and hyphens.
style- What to do with dashes (remove/spaces/commas/periods/hyphens)
ellipsis_normalizer
Normalizes ellipsis usage.
style- Ellipsis style (.../ …)spaces- Add spaces around ellipsis
hyphenation_controller
Manages hyphenation.
action- Add or remove hyphenscompound_words- Handle compound words
space_normalizer
Normalizes spacing.
remove_double- Remove double spacestrim- Trim leading/trailing spaces
i_capitalizer
Capitalizes standalone lowercase 'i' to 'I' (e.g., 'i think' → 'I think').
Numbers & Data
Format numbers, currencies, dates, and measurements.
number_speller
Spells out numbers as words.
max_value- Maximum value to spell outordinals- Handle ordinal numbers
number_compactor
Converts numbers to compact notation (1K, 1M).
min_value- Minimum value to compact
currency_formatter
Formats currency values.
currency- Currency code (USD, EUR, etc.)symbol_position- Symbol placement (before/after)include_thousands_separator- Use thousands separator (optional)decimal_places- Number of decimal places (optional)
percentage_formatter
Formats percentage values.
decimal_places- Number of decimalssymbol_space- Space between number and %
fraction_converter
Converts between fraction formats.
target- Target format (decimal/spelled/fraction)
unit_converter
Converts between units of measurement.
from_unit- Source unitto_unit- Target unitprecision- Decimal precision (optional)
ordinal_formatter
Formats ordinal numbers.
style- Format style (numeric/spelled)
phone_formatter
Formats phone numbers.
region- Country/region codeformat- Format style (international/national)
time_formatter
Formats time values.
format- Time format (12h/24h)show_seconds- Include seconds
measurement_normalizer
Normalizes measurements.
system- Unit system (metric/imperial)precision- Decimal precision
Format & Markup
Convert between formats, handle HTML/Markdown, and manage code.
markdown_to_html
Converts Markdown to HTML.
sanitize- Sanitize HTML outputengine- Converter engine (showdown/remark, optional)gfm- Use GitHub Flavored Markdown (optional)
html_to_markdown
Converts HTML to Markdown.
gfm- Use GitHub Flavored Markdown
html_sanitizer
Removes unsafe HTML.
allowed_tags- Allowed HTML tagsallowed_attrs- Allowed attributes
code_formatter
Formats code blocks.
language- Programming language (optional)indent_size- Indentation size (optional)mode- Formatting mode (wrap_block/wrap_inline/detect/indent, optional)prettify- Apply code prettification (optional)
link_detector
Detects and auto-links URLs.
auto_link- Automatically create linksopen_in_new_tab- Add target blank
html_entity_handler
Encodes or decodes HTML entities.
mode- Encode or decode
markdown_table_formatter
Formats Markdown tables.
alignment- Column alignment (left/center/right)
syntax_highlighter
Adds syntax highlighting to code.
theme- Color themeline_numbers- Show line numbers
json_prettifier
Formats and prettifies JSON with auto-parsing of stringified JSON. Automatically detects and parses single, double, or multiply-stringified JSON at any nesting level.
mode- Output format (pretty/compact/sorted/aligned, default: pretty)indent- Number of spaces for indentation (default: 2)sort_keys- Sort object keys alphabetically (default: false)trailing_newline- Add newline at end of output (default: true)use_prettier- Use Prettier for formatting (default: true)
json_parser
Parses, validates, or extracts JSON from text.
mode- Operation mode (parse/validate/extract, default: parse)on_error- Error handling (preserve/error_message/empty, default: error_message)indent- Number of spaces for indentation (default: 2)
Removal & Redaction
Remove or redact specific types of content from text.
profanity_filter
Filters profanity and inappropriate language.
level- Filter level (light/moderate/strict)mask_char- Character for masking (optional)
url_remover
Removes URLs from text.
mode- Remove or replacereplacement- Replacement text (optional)
hashtag_remover
Removes all hashtags (#tags) from text.
mode- Must be 'remove' (removes all hashtags)
email_redactor
Redacts email addresses.
mode- Mask or removereplacement- Replacement text (optional)
mention_remover
Removes @mentions from text.
platform- Social platform (twitter/instagram/generic)
number_remover
Removes numbers from text.
mode- Remove or replacereplacement- Replacement text (optional)include_currency- Also remove currency valuesinclude_percentages- Also remove percentages
entity_redactor
Redacts named entities (people, places, organizations).
types- Entity types to redactmode- Mask or removereplacement- Replacement text (optional)
SEO & Web
Optimize content for search engines and social media.
meta_description_optimizer
Creates SEO-optimized meta descriptions.
max_length- Maximum character countinclude_keywords- Keywords to include
slug_generator
Generates URL-friendly slugs.
max_length- Maximum slug lengthseparator- Separator character (-/_)
alt_text_generator
Generates alt text for images.
max_length- Maximum alt text lengthdescriptive- Use descriptive style
heading_seo_optimizer
Optimizes headings for SEO.
include_keywords- Target keywordsmax_h1_length- Max H1 length
keyword_density_controller
Manages keyword density for SEO.
target_keyword- Keyword to optimizetarget_density- Target density percentage
social_snippet_formatter
Formats content for social media.
platform- Social platform (twitter/facebook/linkedin)
schema_markup_adder
Adds structured data markup.
type- Schema type (article/product/recipe)
Accessibility
Make content more accessible to all users.
plain_language_converter
Converts to plain, accessible language.
max_grade- Maximum reading gradepreserve_technical- Keep technical terms
screen_reader_optimizer
Optimizes text for screen readers.
add_aria_labels- Add ARIA labelsexpand_abbreviations- Expand abbreviations
abbreviation_expander
Expands abbreviations for clarity.
common_only- Only expand common abbreviationsadd_glossary- Add glossary of termscustom_items- Custom abbreviations (optional)
descriptive_link_text
Makes link text more descriptive.
min_length- Minimum link text lengthcontext_words- Words of context to include
color_reference_remover
Removes color-based references for accessibility.
replacement_strategy- How to handle (describe/remove)
image_reference_handler
Ensures images have proper alt text.
mode- Operation mode (validate/remove/extract_context/generate_alt)require_alt_text- Require alt text for all imagesmin_alt_length- Minimum alt text lengthcontext_words- Number of context words for extraction
Content Transform
Advanced transformations like summarization and expansion.
summary_maker
Creates a summary of the text.
unit- Summary unit (words/sentences)target- Target lengthmust_include- Required phrases (optional)
expander
Expands text with examples and details.
examples- Number of examples to addevidence_first- Lead with evidence
call_to_action_crafter
Adds or enhances calls to action.
audience- Target audiencetone- CTA tone (optional)strength- How strong the CTA should be (0-10)
audience_adapter
Adapts text for a specific audience.
persona- Target audience personagrade- Reading grade level (optional)domain_focus- Domain/industry (optional)
citation_normalizer
Normalizes citations to a specific style.
style- Citation style (APA/MLA/Chicago)in_text_only- Only format in-text citations
Localization
Convert text between regional language variants.
spelling_converter
Converts spelling between American, British, and Canadian English variants (e.g., 'color' ↔ 'colour', 'organize' ↔ 'organise').
target- Target variant (american/british/canadian)