> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rankai.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Control how articles are written

> Steer length, tone, sources and sections with your business profile, writer notes and knowledge base documents.

**RankAI writes from your facts and follows your instructions.** Your business profile says what's true about your business; writer notes say how you want articles written. Both apply to every new article.

> [!NOTE]
>
> **Optional:** add writer notes when you have a house style, length, sources or sections you want in every article.

> [!NOTE]
>
> \*\*In RankAI:\*\***Settings** → **Content & writing** → **Writer**, and **Settings** → **Business profile** · `rankai.ai/dashboard/<project>/settings/content`

## What RankAI does

* Researches each topic on the web and cites sources for factual claims.
* Uses your **Business profile** as the source of truth for facts about your business, such as products, pricing, customers and competitors.
* Adds a short TL;DR at the top and an FAQ section at the end of every article.
* Links to relevant pages on your own website, including pages that help readers become customers.

## Your options

| What you want to change | Where |
| - | - |
| Facts about your business, audience and competitors | **Settings** → **Business profile** |
| Tone, length, sources to use or avoid, sections, calls to action | **Writer notes** |
| Product sheets, research, or brand material to draw from | **Knowledge base** → **Add document** |
| Article language | **Article language**, once multilingual articles are turned on. See [Multilingual articles](https://docs.rankai.ai/workflows/multilingual-articles.md). |

### Write writer notes

1. Open **Settings** → **Content & writing**.
2. In the **Writer** card, click **Edit** next to **Writer notes**.
3. Write your instructions in plain language, then click **Save**.

Short, specific notes work best. For example:

* "Keep articles around 1,500 words."
* "Write for small-business owners. Friendly, plain English, no jargon."
* "Cite government or industry sources. Don't link to competitors."
* "Skip the FAQ section." or "End with a call to book a demo at /contact."

There's no separate length or tone setting: writer notes is the place for both. The title, meta description and URL slug aren't set from writer notes; edit those in the article.

### Add knowledge base documents

In the **Writer** card, click **Add document** under **Knowledge base**. Upload PDF, TXT, Markdown, CSV or JSON files, up to 25 documents and 8 MB each. RankAI reads the passages that match each article's topic during research. If a document disagrees with your business profile, the business profile wins.

### Edit one article with AI

In the article editor, open **AI assistant** to ask for rewrites, summaries or new structure for a section. Each person can apply 20 AI edits a day and 100 a month per project; the panel shows how many are left.

## Avoid these mistakes

* **Expecting old articles to change.** New settings apply to articles written after you save them. Edit existing articles in the editor.
* **Putting business facts in writer notes.** Prices, features and customer details belong in **Business profile**, where every article, keyword pick and AI answer check uses them.
* **Writing long, conflicting notes.** If two notes disagree, the writer has to guess. Keep one clear instruction per topic.

## What to expect

* Check the first article written after you change your notes. If something's off, make the note more specific.
* Instructions guide the writer; they aren't hard rules. For anything that must be exact, like a legal disclaimer, review the article before you publish. See [Review and publish](https://docs.rankai.ai/workflows/review-and-publish.md).

Questions? [Contact support](https://docs.rankai.ai/support/contact.md).

***

*Last reviewed: November 13, 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.