Tag Manager

🧠 Overview

The Tag Manager is the Onimator Helper Suite’s bulk tagging tool for accounts. Instead of opening each account in Onimator and editing its tags one-by-one, you select a subset of devices / accounts here and apply, remove, or read tags in bulk, with optional append-only mode so you don’t overwrite existing tags.

Tags are the labels Onimator uses to group accounts (by client, by niche, by warm-up stage, etc.). They drive features like the Engage tool’s “Skip users already engaged by tag-sharing accounts” cross-account dedup.

💡 Strategic Purpose: Tags are how you organize a multi-account fleet at scale, “all client A’s accounts,” “all warm-up accounts,” “all USA-tagged accounts.” Tag Manager replaces the per-account click-fest with a single bulk-apply screen. Critical the moment you go past ~10 accounts.

🔁 How It Fits with Onimator

Tag Manager reads from and writes to Onimator’s account settings. It doesn’t run any sessions, it just edits the per-account tags field that Onimator and its tools already use.

Bot Folder ← Tag Manager reads/writes account tags → Onimator tools key off the same tags

Examples of tools that consume tags:

• Engage tool — “Skip users already engaged by tag-sharing accounts” (cross-account dedup, requires enable_tags ON).
• Any grouping / filtering view that lets you slice accounts by tag.

🚀 Key Features

• Bulk Apply — write the same tag(s) to every selected account at once.
• Bulk Remove — wipe all tags from selected accounts.
• Bulk Read — pull the existing tags from the selected accounts back into the editor.
• Append vs Replace — Append to existing tags checkbox keeps old tags; without it, the apply overwrites.
• Comma-Separated Multi-Tag — apply multiple tags at once with a comma list.
• Two-Pane Filter — pick which devices on the left, which accounts on the right.
• Filter Accounts by Existing Tag — narrow the right pane to accounts that already have a specific tag.
• Enable Tags Toggle — the master switch for whether the tagging system is active in the bot.

⚙️ Access the Tag Manager

1. Open the Onimator Helper Suite.
2. In the suite’s header, click Select Bot Folder and point at your Onimator bot folder. Required.
3. Click the Tag Manager tab in the top tab row.
4. After Select Bot Folder runs, both panes populate: the Devices pane lists your phones, and as soon as you check device(s) on the left, the Accounts pane fills with the accounts on those device(s).

🔧 Tag Manager Configuration

Top Control Bar

The settings you apply to the selected accounts.

Enable Tags (checkbox)

The master switch for the tagging system. Can be checked or unchecked:

• Checked — tags are active. Tools that read tags (e.g. Engage’s cross-account dedup) will use them.
• Unchecked — tags are still stored but the tagging-based features ignore them.

Tags (comma separated) (text field)

The tags you want to apply on the next Apply Tags click. Multiple tags = comma list.

Examples:

• client-acme — single tag.
• client-acme, niche-fitness, warm-up — three tags applied at once.

Append to existing tags (checkbox)

Controls how Apply Tags writes to accounts that already have tags:

• OFF (default) — apply replaces the account’s tag list with what’s in the Tags field.
• ON — apply adds the new tags to whatever’s already there; existing tags are preserved.

⚠️ Leaving “Append to existing tags” OFF wipes existing tags on apply. If you only want to add a tag to a group of accounts, turn this ON first.

Action Buttons

Below the top control bar:

• Select Bot Folder — opens the folder picker. Same behavior as the suite header’s button.
• Apply Tags — writes the Tags field onto every account selected in the right pane. Respects the Append checkbox.
• Remove All Tags — wipes every tag from every selected account.
• Get Tags from Selected — reads the existing tags off the selected accounts and populates the Tags field. Useful for editing a tag set without retyping it.

Left Pane: Devices

Filter and pick the phone(s) whose accounts you want to work with. Populates after Select Bot Folder.

• Search Device (text field + Clear button) — filter the device list as you type.
• Select All (checkbox at the top of the list) — check it to select every device in the list at once.
• Device list — the phones in the loaded bot folder, each with its own checkbox.

Right Pane: Accounts

Filter and pick the accounts within the selected device(s) that you’ll apply / remove / read tags from. Populates after devices are selected on the left.

• Filter by Tag (dropdown + Clear button) — show only accounts that already have a specific tag.
• Search Account (text field + Clear button) — filter the account list by username.
• Select All / Select None (buttons, top-right) — bulk-toggle the selection in the visible list.
• Account list — each entry shown as <DeviceID> - <username> (e.g. R58N34VNGJW - justliaacc), with its own checkbox.

📅 Recommended Workflow

Tag a New Batch of Accounts

1. Select the device(s) on the left.
2. Use Filter by Tag = (leave blank) and Search Account to find the new accounts.
3. Select All in the right pane (or check individually).
4. Top bar: type your tags (e.g. client-acme, niche-fitness).
5. Decide on Append to existing tags, ON if these accounts already have tags you want to keep, OFF if you want to set fresh tags.
6. Click Apply Tags.

Add a Tag to a Group That Already Has Tags

1. Pick device(s).
2. Filter by Tag = the existing group tag (e.g. client-acme) so only that group shows.
3. Select All.
4. Top bar: type just the new tag (e.g. priority).
5. ✅ Append to existing tags: ON — critical, or you’ll wipe client-acme and replace it with priority.
6. Apply Tags.

Re-Tag a Group

1. Pick device(s).
2. Filter by Tag = the old tag.
3. Select All to grab the whole group.
4. Get Tags from Selected to see what they currently have.
5. Edit the Tags field with the new desired tag list.
6. Append: OFF (you’re replacing).
7. Apply Tags.

Wipe Tags Off Specific Accounts

1. Pick device(s).
2. Select the accounts in the right pane.
3. Click Remove All Tags. ⚠️ Removes every tag from the selection.

🔐 Best Practices

Always Select Bot Folder First

Without it, both panes stay empty. Universal rule across the OniHelper suite.

Mind the Append Checkbox Before Hitting Apply

The single most common mistake in this tool. OFF replaces; ON adds. Pause and check before clicking Apply on a group with existing tags.

Use “Get Tags from Selected” to Audit Before Editing

Before you change tags on a group, click Get Tags from Selected to see what’s actually there. Cheap way to avoid wiping a tag you didn’t know existed.

Tag with a Convention

Pick a naming scheme and stick to it: client-X, niche-X, stage-X, region-X. Searchable, filterable, predictable.

Pair Enable Tags ON with Cross-Account Dedup

If you’re running Engage with “Skip users already engaged by tag-sharing accounts”, make sure Enable Tags is checked here and the accounts genuinely share at least one tag, otherwise the dedup quietly does nothing.

Use Filter by Tag for Surgical Bulk Edits

Don’t manually click 30 checkboxes. Filter to the group, Select All, edit. Faster and less error-prone.

⚠️ Common Issues

Device or Account List Is Empty

Cause: Bot folder isn’t set, or the folder doesn’t contain devices yet. Fix: Click Select Bot Folder → re-point at your Onimator install.

Apply Tags Wiped My Existing Tags

Cause: Append to existing tags was OFF (the default). Apply replaces. Fix: Re-tag the affected accounts; for the next round, turn Append ON before clicking Apply.

Tag-Driven Features Aren’t Behaving (e.g. Engage cross-account dedup)

Cause: Enable Tags is unchecked, so tools ignore the tags even though they’re stored. Fix: Check Enable Tags, then re-run the tool.

Filter by Tag Shows No Accounts

Cause: No accounts on the selected device(s) carry that tag, or the filter typo’d. Fix: Clear the filter to confirm accounts exist on the device, then re-check the tag spelling.

🏁 Conclusion

• Bulk tag editor for accounts in the Onimator bot folder.
• Three core operations — Apply Tags, Remove All Tags, Get Tags from Selected.
• Append vs Replace — Append to existing tags is the toggle that decides which.
• Enable Tags master switch — controls whether tag-driven features (like Engage cross-account dedup) actually read the tags.
• Two-pane filter — devices on the left, accounts on the right, with search + tag filter on both sides.

💡 Implementation Tip: Adopt a consistent tag naming scheme (client-X, niche-X, stage-X) the first day you start using Tag Manager. Then your future bulk operations are one-click: filter by client-acme, Select All, Apply Tags. The accounts that grow into chaos are the ones that started without a convention.

🎥 Tutorials & Support

• No transcript for this module yet — article built from UI screenshots only.
• Telegram Support: Join Onimator Support