Templates Buttons

ProIMDb Customizations Documentation

This page explains all customization features available in ProIMDbOT, including template formatting and result button controls. Every command block is copy-ready, and examples are written for both beginners and advanced users.

Start Here

Use /templates to open this docs shortcut inside bot chat.

For Beginners

Copy one preset first, test with a movie search, then customize line by line.

Safe Reset

At any time run /template reset to return to defaults.

Quick Navigation

Quick Start Templates Buttons Layout Studio Fixes

Quick Start

Fast path for first-time setup.

Choose your mode: markdown, html, or plain.
Run mode command first.
Paste a preset using /template set ....
Search any title and verify output.

Template Commands

Core commands to control message templates.

Show current template and mode

Command

/template

Reset to default template

Command

/template reset

Switch to Markdown mode

Command

/template mode markdown

Switch to HTML mode

Command

/template mode html

Switch to Plain mode

Command

/template mode plain

Save custom template

Pattern

/template set YOUR_TEMPLATE

Template Placeholders

Use placeholders exactly as shown, including braces.

Placeholder	Description
{title}	Movie or show title
{year}	Release year
{aka}	Also known as title
{rating}	IMDb rating
{votes}	Vote count
{imdb_id}	IMDb ID
{kind}	Item type (movie, series, etc)
{runtime}	Runtime details
{seasons}	Season count for series
{streaming_on}	Streaming platform names
{genres}	Genres list
{languages}	Languages list
{countries}	Countries list
{plot}	Plot summary
{directors}	Director names
{writers}	Writer names
{actors}	Actor names
{directors_links}	Director names with links
{writers_links}	Writer names with links
{actors_links}	Actor names with links
{certificate}	Age certificate
{rel_date}	Release date
{imdb_url}	IMDb URL
{read_more}	IMDb full credits cast URL
{justwatch_url}	JustWatch search URL (same as Details page button)
{letterboxd_url}	Letterboxd URL (IMDb ID search)
{rotten_tomatoes_url}	Rotten Tomatoes URL (auto movie/tv path)
{poster}	Poster URL
{trailer}	Trailer URL
{trailer_id}	Trailer ID

Important: placeholders are case-sensitive.

Smart behavior by type: for TV/Series, {letterboxd_url} and runtime lines are auto-hidden; for Movies, seasons lines are auto-hidden.

Template Presets

Copy and use directly in bot chat.

Preset 1: Balanced Markdown

Step 1

/template mode markdown

Step 2

/template set *{title}* ({year})
_{aka}_
Rating: *{rating}/10* ({votes})
Type: {kind} | Runtime: {runtime}
Genres: {genres}
Languages: {languages}
Release: {rel_date}
Plot: _{plot}_
Director: {directors_links}
Writer: {writers_links}
Cast: {actors_links}
IMDb: [Open IMDb]({imdb_url})
Letterboxd: [Open Letterboxd]({letterboxd_url})
Rotten Tomatoes: [Open RT]({rotten_tomatoes_url})

Preset 2: Rich HTML

Step 1

/template mode html

Step 2

/template set <b>{title} ({year})</b>
<code>{aka}</code>
<b>Rating:</b> {rating}/10 ({votes})
<b>IMDb ID:</b> <code>{imdb_id}</code>
<b>Type:</b> {kind}
<b>Release:</b> {rel_date}
<b>Runtime:</b> {runtime}
<b>Genres:</b> {genres}
<b>Language:</b> {languages}
<b>Plot:</b> {plot}
<b>Director:</b> {directors_links}
<b>Writer:</b> {writers_links}
<b>Cast:</b> {actors_links}
<a href="{imdb_url}">Open IMDb</a>
<a href="{letterboxd_url}">Open Letterboxd</a>
<a href="{rotten_tomatoes_url}">Open Rotten Tomatoes</a>

Preset 3: Minimal Plain

Step 1

/template mode plain

Step 2

/template set {title} ({year})
AKA: {aka}
Rating: {rating}/10 ({votes})
IMDb: {imdb_id}
Type: {kind} | Runtime: {runtime}
Genres: {genres}
Languages: {languages}
Release: {rel_date}
Director: {directors}
Writer: {writers}
Cast: {actors}
Link: {imdb_url}
Letterboxd: {letterboxd_url}
Rotten Tomatoes: {rotten_tomatoes_url}

Button Commands

Customize private and inline result buttons independently. Recommended flow is now fully visual via ProIMDb Studio.

Run /settings in bot chat, tap Open ProIMDb Studio, then use drag-and-drop layout editing with live Telegram preview.

Open visual settings editor (recommended)

/settings

Show all button settings

/buttons

Show private settings

/buttons private show

Show inline settings

/buttons inline show

Enable trailer in private mode

/buttons private on trailer

Disable watchlist in inline mode

/buttons inline off watchlist

Enable Letterboxd in private mode

/buttons private on letterboxd

Enable Rotten Tomatoes in inline mode

/buttons inline on rotten

Reset all button settings

/buttons reset all

Advanced: place Trailer at row 1, column 2

/buttons private place trailer 1 2

Advanced: place Watchlist at row 3, column 1

/buttons inline place watchlist 3 1

Button Layout Guide

Latest Studio layout system: row-based arrangement with drag and drop for both default and custom buttons.

How layout works now: Studio arranges enabled buttons automatically by rows, then lets you fine-tune position by dragging.

Set Arrangement By Rows to control keyboard density, then drag buttons to reorder inside the preview layout.

Control	What It Does	Tip
Mode Toggle	Switch between private and inline keyboard configurations	Each mode is saved separately
Visibility Toggles	Show or hide default buttons	Disable first, then rearrange for cleaner output
Arrangement By Rows	Controls how many rows are used for enabled default buttons	Use 2 rows for balanced layouts, 3+ for compact columns
Drag Default Buttons	Changes row and column order directly	Move highest-priority actions to first row
Drag Custom Buttons	Reorders custom URL buttons	Add buttons first, then sort by importance

Recommended Studio Flow

Run /settings in bot chat and open ProIMDb Studio.
Wait for connection/login check to complete.
Click Start Editing to reveal editor panels.
Pick mode: Private Result or Inline Result.
Toggle default buttons ON/OFF in the Visibility block.
Set Arrangement By Rows based on your preferred compactness.
Drag default and custom buttons until preview matches your desired keyboard.
Use Save Layout to commit changes.

Layout Patterns

Pattern A: Balanced Two Rows

Great default for most users with clear top actions and secondary links below.

Rows: 2 • Top: ProIMDb + Trailer • Bottom: Letterboxd + RT + Watchlist

Pattern B: Priority-First

Keep one critical action easy to tap by placing it first and leaving more spacing below.

Rows: 3 • Row 1: ProIMDb + Trailer • Row 2: Watchlist • Row 3: utility links

Pattern C: Utility Stack

Best when you add many custom links and want predictable vertical scanning.

Rows: 4 • Use fewer default buttons and order custom buttons by importance

Important Notes

Private and inline layouts are fully independent.
Custom button creation in Studio only asks for label + URL; ordering is handled in Button Layouts.
Commands panel mirrors your current mode configuration and can be copied for backup/migration.
If layout becomes noisy, use Reset Default in Button Layouts and rebuild quickly.

Command Alternative

You can still use command-level placement when needed:

Private trailer to Row 1, Col 2

/buttons private place trailer 1 2

Inline watchlist to Row 3, Col 1

/buttons inline place watchlist 3 1

ProIMDb Studio Documentation

Detailed guide for the modern web editor workflow.

Entry point: Open bot settings with /settings, then tap Open ProIMDb Studio.

Studio is now the primary place for template editing, live preview, button visibility, layout arrangement, and custom URL actions.

Startup and Access Flow

Studio opens with a connection/loading screen while authentication is verified.
After connection is ready, hero panel appears with ProIMDb Customization Studio heading.
Click centered Start Editing button to reveal editor sections.
If not signed in, Studio prompts Telegram login before editor access.

Studio Sections and Purpose

Section	What You Configure	Notes
Live Preview	Template output + keyboard rendering	Template text appears only when a custom template exists
Message Templates	Mode and template body	Supports html, markdown, and plain
Button Layouts	Visibility, row arrangement, drag reorder	Per mode: private and inline
Custom Buttons	Add label + URL buttons	No style picker; reorder from layout area
Command Export	Auto-generated /buttons commands	Useful for backup and sharing
Docs Deep Links	Fast links to docs sections	Jumps directly to relevant help

Template Editing Rules

Choose template mode first: markdown, html, or plain.
Validation runs instantly in Studio and also server-side before save.
If template field is empty, preview does not show default text block.
Use reset to return template to default backend behavior.

Button and Custom Action Rules

Default button visibility and positions are saved per mode.
Custom buttons require only label and valid http/https URL.
Custom button order can be changed from the layout arrangement area.
Use reset options for quick recovery when experimenting.

Recommended Daily Workflow

Open Studio from bot settings.
Start Editing and pick mode.
Adjust template and verify preview.
Tune visibility and drag layout order.
Add custom buttons and reorder if needed.
Save and copy command export as backup.

Button Presets and Examples

Quick examples for adding and managing custom URL buttons.

Add custom button (private mode)

/buttons private add stack "Download" https://example.com

Add custom button (inline mode)

/buttons inline add stack "Website" https://example.com

Clear custom buttons only

/buttons private clearcustom

Reset only inline mode buttons

/buttons inline reset

In Studio, custom button creation no longer asks for Row/Stack style. Just add Label + URL, then reorder position in Button Layouts.

Settings Panel Flow

Current flow is Studio-first with a guided web editor.

Run `/settings`

In bot settings, tap Open ProIMDb Studio to launch the web editor.

Wait for Connection Loader

Studio now shows a loading screen during login and connection checks. Main editor appears only after connection succeeds.

Tap Start Editing

The hero section is shown first. Use centered Start Editing button to enter the full editor.

Customize Template and Buttons

Add custom buttons with just label + URL, then reorder in Button Layouts. Live preview shows template text only when a custom template exists.

/settings

03:31

⚙️ Settings

Open ProIMDb Studio to edit:
• Message template
• Private/Inline layouts
• Custom URL buttons

03:31

🌐 Open ProIMDb Studio

📘 Customization Docs

Message

Troubleshooting

Common issues and quick fixes.

Template failed to save

Double check for unmatched braces like {title or illegal characters in custom mode.

HTML tags not working

Ensure you have run /template mode html before setting an HTML template.

Links not clickable

Use /template mode markdown and verify the [text](url) format.

Letterboxd for TV

Automatically hidden for TV/Series titles as Letterboxd is movie-only.

Runtime/Seasons

{runtime} auto-hides for TV; {seasons} auto-hides for movies.

Need fresh start?

Run /template reset to clear all custom settings and return to defaults.

ProIMDb Customizations Documentation

Quick Start

Template Commands

Template Placeholders

Template Presets

Button Commands

Button Layout Guide

Recommended Studio Flow

Layout Patterns

Important Notes

Command Alternative

ProIMDb Studio Documentation

Startup and Access Flow

Studio Sections and Purpose

Template Editing Rules

Button and Custom Action Rules

Recommended Daily Workflow

Button Presets and Examples

Settings Panel Flow

Run /settings

Wait for Connection Loader

Tap Start Editing

Customize Template and Buttons

Troubleshooting

Template failed to save

HTML tags not working

Links not clickable

Letterboxd for TV

Runtime/Seasons

Need fresh start?

Run `/settings`