Getting started

Find your way around Tartol

A plain-language map of the dashboard, sidebar, account controls, and common destinations.

4 min readUpdated August 27, 2026Open in Tartol
Search or browse all guides

Quick visual guide

Use the sidebar for product areas and the Knowledge Base search for help.

  1. 1

    Choose an area

    The left sidebar takes you to Research, Creative Studio, Help, and the other product areas.

    Tartol app with the sidebar and Discovery openMain navigation
  2. 2

    Search for help

    On /docs, type the task in normal words, such as “create image ad” or “invite teammate.”

    Knowledge Base home with its search fieldSearch any task

Red labels show the exact control to use.

Detailed referenceOpen this for definitions, limits, examples, and troubleshooting.

The main areas

Selected cards, rows, filters, and sidebar items use a subtle neutral highlight with a grey border or indicator. Discovery uses a background highlight for the selected All Ads or Product Match tab, without an underline. Other active tabs keep the primary highlight: lime in dark mode and blue in light mode. Checked controls use neutral marks. The appearance adapts to light and dark themes; keyboard focus on buttons, links and other controls still has a separate neutral outline, while text fields show focus with their cursor and no outline. Lime in dark mode remains the primary action and brand color, so a selection does not look like a Generate, Save, or purchase button. Selection behavior, saved preferences, permissions, and public REST/MCP contracts are unchanged.

  • Dashboard shows workspace activity, plan information, credits, and shortcuts. Its summary cards are ordered Ads Tracked, Ads Generated, and Ads Launched. Ads Launched counts every ad created in the selected dates across the connected Meta ad accounts (everything Ads Manager lists, plus ads published through Tartol) and links to Ads Manager. Ads Generated includes completed image creatives and all saved Copywriter outputs: ad text, emails, landing-page copy, and video scripts. Copy outputs count in the selected date range and comparison trend, scoped to the current workspace. The public Dashboard API, MCP dashboard overview, and Tartol Agent use the same totals. Longest streak, with a small orange flame icon, sits at the bottom left of the Activity Heatmap, on the same row as the Less–More legend. The year label and navigation arrows appear only when the workspace spans more than one calendar year, from its creation year through the current year. Longest streak is the highest number of consecutive calendar days with any activity in the selected heatmap year and Workspace or Individual view. Multiple events on one day count once, an empty day breaks the streak, and future dates are excluded. A streak crossing New Year is counted separately within each displayed year. The public GET /api/v1/dashboard endpoint and MCP dashboard_overview include longestStreak with days and year for the current workspace and current year.
  • Brands is the source of truth for the products and offers you advertise.
  • Creative Studio contains every generation, editing, copy, and creative-history workflow.
  • Ads Manager monitors Meta performance, manages campaigns, builds new Paused Sales or Traffic structures, and publishes Tartol or Media Library assets. It is currently a super-admin-only production preview and is hidden from other accounts.
  • Discovery is the searchable ad library; Brand Tracker monitors brands over time.
  • Saved Ads stores research in folders and boards; Ads Manager opens your central reusable launch assets in the Media Library modal.
  • Help opens Tartol Agent for guided assistance and opens the Knowledge Base in a new browser tab for step-by-step documentation.
  • Settings contains profile, notifications, security, API keys, MCP connections, and account controls.

Fast navigation and live updates

Slow page reads keep their loading state and retry temporary failures quietly in Discovery, Saved Ads, Brand Tracker and Insights, Creative Studio, filter menus, Tartol Agent data panels, and super-admin Command Center reports. Completed reads are retained while only interrupted reads retry. Changing the page, filter, or workspace cancels obsolete reads. Dashboard ad-status checks also retry temporary read failures without an error notice. Confirmed access denials and invalid responses can still require attention.

These browser loading changes are a presentation-only exception: public REST and MCP retain their existing errors and access checks. Tartol Agent explains the behavior without adding an action tool. Password reset keeps waiting for the submitted request; it does not cancel after thirty seconds or automatically resubmit the password change.

Returning to Dashboard, Brands, Discovery, or Saved Ads can show the last loaded content immediately while Tartol checks for newer data in the background. These browser snapshots belong to your account, workspace, and selected filters. First visits still need to load data. Background refreshes keep loaded content visible without refresh-error banners or retry notices. This also applies to Brand Tracker, Ads Manager reports, and filter options. Dashboard retries failed summary reads automatically in the background without displaying refresh warnings. Hovering or focusing a sidebar destination prepares that page for navigation when your connection allows it.

Import and generation progress continue updating separately from saved page content. Returning to a tab, reconnecting to the internet, or restoring the live connection triggers fresh status checks. Brand Tracker clears completed import activity from fresh server status; cached cards cannot keep the importing badge active. Large scrolled ad lists keep their place during background recovery; reopen the list to reload its ordering from the beginning.

Workspace can restore its member list immediately, but management permissions, invitations, and credit limits are checked again. Background refresh preserves an unsaved workspace name. Affiliates shows the account before auxiliary tables finish; Commissions and Payouts load when selected, and a dash means that a count has not loaded yet. Billing, Workspace, Affiliates, and Support check their current view when you return to a tab or reconnect. Private financial and support data are not saved as page snapshots. Workspace, Affiliates, Billing, and Support retain loaded content and retry temporary background read failures quietly; changing a selection cancels obsolete reads. An initial load that fails or an access denial can still require attention. Creative Studio loads preview media on demand and respects reduced-motion preferences.

Browser navigation caching does not add a public REST API endpoint or MCP action. Quiet background refresh is also a presentation-only exception: public REST and MCP keep their existing error responses, validation, and access checks. Those clients keep reading current server state through their existing scoped requests. Tartol Agent can explain refresh behavior and help troubleshoot it; it does not clear caches or start another import for you.

On smaller screens

Use the menu button to open the sidebar. Selecting a destination closes it automatically. Some dense research views work best in Grid or List mode rather than trying to fit every detail on one card.

When you are unsure where to go

Open Tartol Agent and ask how a Tartol workflow works, or search this Knowledge Base using normal words such as “save an ad,” “invite teammate,” or “create API key.”

Keep learning

Still need help?

Tell us what you were trying to do and what happened. Our guide to reporting a problem lists what to include.

Last updated August 27, 2026