Brand Profile

​

Purpose

The Brand Profile page is the central hub for defining and managing a customer’s brand identity. It helps the Athena AI understand how to represent the brand, what topics or traits to focus on, and how to format AI-generated content. By providing core business details, tone guidelines, writing rules, and technical SEO files (like sitemaps and llms.txt), customers ensure that Athena generates on-brand, AI-optimized content and accurately tracks how external AI crawlers interact with their site.

​

What’s on the page

The page is divided into five main tabs. Note: The Rules tab is conditionally visible based on the customer’s subscription plan (requires the content memory feature).

​

General Tab

• Basic Info: Fields to edit the brand name, select an industry, upload a square website logo, and write a brand description.
• Language & Location: Dropdowns to set the default language and base country for the brand.
• Save Button: Persists any changes made in this tab.

​

Attributes Tab

• Brand Attributes: A section to define specific traits that guide how Athena evaluates AI responses and generates content.
• Brand Attributes Table:
  • Attribute: The name of the brand attribute (e.g., ‘professional’, ‘authoritative’).
  • Sentiment: Whether the attribute is Positive (brand should embody it) or Negative (brand should avoid it), indicated by a triangle icon.
  • Actions (⋯ menu): An overflow menu containing a Delete option.
• Attribute Backfill Bar: A floating command bar that appears automatically whenever attribute changes are made. It allows users to reanalyze historical responses using their newly updated attributes.

​

Rules Tab (Conditional)

• Brand Rules Table: Lists all global writing rules (brand memories) that apply across all generated content.
  • Rule: The text of the writing rule (e.g., ‘Stop using em dashes’). Clicking the row opens the edit dialog.
  • Category: The category of the rule (e.g., Style, Formatting, Terminology, Tone, Structure, Other).
  • Status: A toggle switch to enable or disable the rule for content generation.
  • Actions (⋯ menu): An overflow menu containing Edit and Delete options.

​

Brand Kits Tab

• Brand Kits Table: Lists brand kits used to dictate tone, voice, and style guidelines.
  • Name: The name of the brand kit.
  • Status: Current state of the brand kit. Can show as Default, Draft (with tooltip: “Setup is incomplete: click to continue”), In progress (generating), Failed (with tooltip: “Generation failed: click to retry”), or a ‘Set as default’ button.
  • Actions (⋯ menu): An overflow menu containing Edit and Delete options.

​

Technical Tab

• LLMs.txt: A section to generate or edit the llms.txt file (with tooltip: “Tells AI models what your site is about and how to represent your brand. Think robots.txt but for LLMs.”).
• Sitemap: A section to generate and manage XML sitemaps (with tooltip: “A sitemap lists all your website’s pages so search engines and AI crawlers can find and index your content. Without one, pages may be missed entirely.”).
• Schema: A tool to validate JSON-LD structured data on the website (with tooltip: “Validate Schema.org JSON-LD structured data on your website. Helps AI crawlers and search engines understand your content.”).
• AI Accessibility: A checker to see if major AI models can access the site’s content (with tooltip: “Check whether major AI models and crawlers can access your site’s content.”).

​

What you can do here

​

General Actions

• Save changes (General tab): Persists updates to the brand name, description, industry, language, and base country.
• Upload logo: Drag and drop an image file or click to browse. Uploads a square image as the brand logo (max 2 MB).

​

Attribute Actions

• Create new: Opens a dialog to add a new positive or negative brand attribute.
• Add (dialog): Saves the new attribute with the selected sentiment.
• Delete attribute: Located in the ⋯ menu. Soft-deletes the attribute from active tracking.
• View Changes (Backfill Bar): Opens a dialog listing all pending attribute additions, edits, or deletions.
• Dismiss change (View Changes dialog): Removes a single attribute change from the pending backfill list without executing the backfill.
• Dismiss all (View Changes dialog): Clears all pending attribute changes from the backfill list.
• Backfill (Backfill Bar): Starts a background workflow to reanalyze historical responses in the selected date range using the updated attributes. Consumes subscription credits. (Hover tooltip: “Reanalyze [number] responses with updated attributes ([number] credits)”).

​

Rule Actions

• Create New: Opens a dialog to add a new global writing rule.
• Add rule (dialog): Saves the new writing rule and optional category.
• Edit rule: Located in the ⋯ menu (or by clicking the row). Opens a dialog to modify the rule text or category.
• Save (dialog): Persists changes to the rule.
• Toggle rule active: Toggles the status switch in the table to enable or disable the rule without deleting it.
• Delete rule: Located in the ⋯ menu. Opens a confirmation dialog (“Are you sure you want to delete this rule? This action cannot be undone.”).

​

Brand Kit Actions

• Create New: Opens the Brand Kit creation modal wizard.
• Next / Back (Modal): Navigates back and forth through the brand kit setup wizard steps.
• Generate (Modal): Triggers AI generation of brand guidelines based on the blog URL, tones, and uploaded files.
• Edit: Located in the ⋯ menu or by clicking the row. Opens the Brand Kit modal pre-populated with the kit’s existing data.
• Set as default: Click the button in the status column to mark the selected brand kit as the primary kit for content generation.
• Retry: Click the red Failed pill to retry AI generation for a brand kit that failed previously.
• Delete brand kit: Located in the ⋯ menu. Opens a confirmation dialog (“Are you sure you want to delete “[name]”? This action cannot be undone.”).

​

Technical Actions

• Generate llms.txt: Triggers AI generation of an llms.txt file. Once generated, this button is replaced by “Edit llms.txt”.
• Edit llms.txt: Opens a dialog to view and manually edit the llms.txt content.
• Save (llms.txt dialog): Persists the edited llms.txt content.
• Generate (Sitemap): Crawls the website (or a designated subdirectory) to generate an XML sitemap.
• Sitemap dialog actions: Clicking a generated sitemap card opens a dialog where you can Copy XML, Download, paginate through results (First / Previous / Next / Last), or Delete sitemap.
• Validate (Schema): Fetches the entered URL and validates any JSON-LD structured data blocks found.
• Try example (Schema): Pre-fills the URL field with an example domain (e.g., schema.org) and runs validation immediately.
• Check AI accessibility: Opens a dialog to check whether major AI crawlers are successfully accessing the site.
• View & Edit robots.txt: Opens a dialog to view and edit the cloud-hosted robots.txt file.

​

Data shown

• Current brand settings: The saved name, description, industry, location, language, and uploaded logo for the workspace.
• Configured brand guidelines: The attributes, brand kits, and writing rules that have been created to guide the AI’s content generation.
• Generated technical files: The stored llms.txt text and XML sitemap records associated with the website.
• Live SEO data: The robots.txt, Schema.org JSON-LD data, and crawler accessibility status pulled live from the customer’s actual website URL.
• Historical responses: Used to calculate the credit cost of an attribute backfill.

​

Common workflows

1. Update general brand information

1. Navigate to Brand Profile → General tab (the default view).
2. Update the Brand Name, Industry, Brand Description, Base Location, or Default Language fields.
3. Optionally upload a new logo by dragging and dropping a square image into the logo box.
4. Click “Save changes” in the bottom right to apply all updates.

2. Add a brand attribute and backfill data

1. Navigate to the Attributes tab and click “Create new”.
2. Enter the attribute name (e.g., “authoritative”) and select whether it is Positive or Negative, then click “Add”.
3. The floating Attribute Backfill Bar will appear at the bottom of the screen.
4. Select a date range, verify the credit cost, and click “Backfill” to rescore historical AI responses against the new attribute list.

3. Create a new brand kit

1. Navigate to the Brand Kits tab and click “Create New”.
2. Follow the setup wizard: provide a brand kit name, input a blog URL, and advance to the next step.
3. Customize your settings by defining tone descriptors or uploading supporting brand documents.
4. Click “Generate” to let Athena build your comprehensive brand guidelines.

4. Generate and manage a sitemap

1. Navigate to the Technical tab.
2. In the Sitemap section, optionally enter a subdirectory (like “blog”).
3. Click “Generate” to crawl the site.
4. Expand the “Generated sitemaps” section and click the sitemap card to view, copy, download, or delete the resulting XML.

​

Empty, loading, and error states

• Empty states:
  • Brand Kits: Shows “No brand kits yet. Create your first brand kit to get started.”
  • Attributes: Shows “No attributes yet. Add positive or negative traits to define your brand voice.”
  • Rules: Shows “No rules yet. Add a rule or create one from iterate edits in the content editor.”
  • Sitemap: The “Generated sitemaps” accordion is completely hidden until at least one sitemap exists.
  • Schema: Displays no validation results until a URL is entered and “Validate” is clicked.
• Loading states: Tables show skeleton placeholder rows while fetching data. Buttons display spinners while actions (like saving or generating) are in progress.
• Error states: Displayed as toast notifications (e.g., if a logo upload fails, a brand kit fails to save/delete, or sitemap generation errors out). If Schema validation hits a parse error, it displays “Invalid JSON” directly in the UI alongside hints on how to fix it.

​

Linked from / links to

• Linked from:
  • The main sidebar navigation (“Brand Profile”).
  • The onboarding tour (step 8 points directly here).
  • External or internal deep links utilizing URL query parameters (e.g., ?tab=attributes&open-attributes=true or ?startTour=brand-guidelines).
• Links to:
  • The Traffic page (via the “View setup instructions” link under the robots.txt section).
  • External schema.org documentation from the Schema validator empty state.
  • External sitemaps.org protocol documentation from the Sitemap collapsible.

​

Common support questions

Why can’t I upload my logo? Logos must be perfectly square (the width and height must match exactly) and under 2 MB in file size. If the image is rectangular or too large, the upload will be rejected with an error. Where is the Rules tab? The Rules tab is only visible to users whose subscription plan includes the content memory feature. If a customer is on a plan without this feature, the tab will be hidden entirely. Why is my Brand Kit stuck in “Draft”? A “Draft” status means the setup wizard was exited before completion. The customer just needs to click the Draft pill (or the table row) to reopen the wizard and finish the setup process. Why can’t I click the “Save changes” button? Users with the “Viewer” role cannot make or save changes on this page. If a Viewer attempts to interact with restricted features, they will see an “Insufficient permissions” error. The Save button is disabled for Viewers. Why can’t I delete a specific Brand Kit? You cannot delete the brand kit that is currently set as the “Default”. To delete it, you must first assign the “Default” status to a different brand kit. What does the “Backfill” bar do, and why did it appear? When a customer adds, edits, or deletes a brand attribute, the Backfill bar appears. It allows the customer to reanalyze their historical AI responses to see how they perform against the newly updated attributes. Because this requires AI processing, running a backfill consumes subscription credits based on the number of responses in the selected date range.