How to get the most out of MadWords.
MadWords writes content designed to rank. But content is one step, not the whole game. Here are some things to do to get the best results with MadWords:
None of this is specific to MadWords. It is what ranking has always required, whether the words come from a tool or a writer. We tell you because we have run SEO campaigns ourselves and we would rather you win. The full reasoning is below.
MadWords writes from what you tell it. Give it correct information about your business and it writes content that needs no editing. A local business needs to give it more, like its location, service area and hours.
When you set up your Topic, MadWords pulls the information and writes about your product or service. We recommend that you review the information and add more if there is more to write about. A few extra minutes of setup gives you great articles that need no editing for as long as you use MadWords.
This is the most important step. Everything MadWords writes is shaped by your Topic.
You do this once. A Topic is not per article and not per project. Build it once for a subject and it powers unlimited Bulk Write, Write, Translate and Refresh projects, and anything we add later. A few minutes here is a few minutes total, not a few minutes each time.
One niche, industry, or product line = one Topic. A Topic is not per site. If you write about six different subjects, you need six Topics, each with its own setup — because the description, products, and audience are different for each one, and that is exactly what makes the articles specific instead of generic.
Create as many as you want, there is no limit on Topics. What your plan limits is the number of domains you can publish to, translate, or refresh.
| Topic Name | A short name for this Topic. Example: "Coffee Reviews" or "SaaS Marketing Blog" |
| Domain | The website where this content will be published. |
| Description | What your business does and the problem it solves. MadWords fills it in from your site. Read it and add anything it missed. This field has more effect on your articles than any other. |
| Product or Service Name | Optional. The product or service you’re selling, so your articles can include it. |
| Unique Selling Proposition | Optional. What makes you different from competitors. If you don’t tell MadWords, it can’t set your content apart from everyone else’s. |
Add these to your Description. The more of them it has, the better your articles:
If you publish to WordPress, connect your site in your Topic so MadWords can publish straight to it. Publishing somewhere else? Skip this and keep your articles in MadWords instead.
| WordPress Site URL | Your site's full address, including https:// — for example, https://yoursite.com. |
| Username | The username you use to log in to WordPress. |
| App Password | Not your normal login password. In WordPress, go to Users → Profile → Application Passwords, add one named “MadWords,” and paste the generated password here. It works on WordPress 5.6+ and can be revoked any time without affecting your login. |
With all three filled in, click Test Connection. MadWords checks that it can reach your site and publish to it — get the green confirmation before you run a batch, so a publish doesn't fail later.
It is almost always one of four things, and none of them mean you did it wrong.
Your site is not on HTTPS. WordPress disables Application Passwords on sites without SSL, so the section will not even appear in your profile. Get a certificate installed and it comes back.
Your server is stripping the login header. Common on Apache running PHP as CGI or FastCGI — the credentials never reach WordPress, so it rejects a request that was actually correct. Adding this line to your .htaccess usually fixes it:
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
A security plugin is blocking the REST API. Wordfence, Solid Security, All In One WP Security and others all have settings that restrict REST API access or disable Application Passwords outright, and they are often switched on by default. Check the plugin’s settings and allow REST API authentication.
Your host restricts the REST API. Some managed hosts lock it down. Support can usually enable it if you ask.
Still stuck? Contact support and we will work through it with you. In the meantime you can select MadWords Only in Bulk Write and publish manually — nothing about your account depends on the WordPress connection.
This is how you build topical authority — not just find a keyword here and there. Google doesn't only rank individual articles; it rewards sites that cover a topic completely. The Keywords tool maps the whole topic for you: enter a competitor URL and MadWords extracts every keyword they wrote about, plus headline ideas you can turn into articles.
Already have a keyword list? You can paste it straight into Bulk Write and skip this step. But keyword research is included in your plan, so there is no reason to leave it on the table — the gap analysis alone usually turns up terms a paid tool missed.
| Your Website | Optional. Select one of your websites and MadWords finds the keyword gaps: topics your competitor covers that you don't. |
| Competitor's Website | Enter the competitor's domain. MadWords analyzes their content and extracts the keywords they wrote about. |
Click Find Pages to start. A scan usually finishes in a couple of minutes. A very large site can take five minutes or more, and MadWords shows you the progress while it runs, so you are not guessing whether it is still working.
MadWords returns a deduplicated list of keywords and headline suggestions. Filter by length, sort, or pull the long-tail terms (3+ words) that are easier to rank for — if your site is new, start there. Then select the full set that covers a topic — not a scattered handful — and send them straight to Bulk Write to write the whole cluster at once.
Bulk Write is the fastest way to generate content at scale. Enter a list of keywords, select your Topic, and MadWords writes a unique, research-backed article for each one.
| Topic | Select the Topic you created in Step 1. This is what tells MadWords about your business. |
| Project Name | A label for this batch. Example: "March Coffee Articles" or "Competitor Gap Keywords." |
| Project Type | Keywords — paste a list of keywords, one per line. RSS Feed — pull topics from an RSS feed. |
| Article Type | Sort your keywords into groups, like Reviews, Listicles and How-tos. Each group is written in the structure that fits it. |
Choose where your articles go after generation:
| WordPress + MadWords | Publishes to the WordPress site connected to your Topic, in the category you choose. |
| MadWords Only | No WordPress required. Articles are stored in your MadWords account, where you can edit them and then move or export them to any platform you want. |
| Posts Frequency | You set how many articles are written and published each day, so 500 keywords don’t land on your site at once. Choose Immediately to write the whole batch now. |
| Draft or Published | Choose whether articles arrive in WordPress as drafts for review, or go live automatically. Start with drafts on your first batch so you can see what you are getting. |
| Word Estimate | Before you start a project, Bulk Write shows you the estimated words it will use. You know what a batch costs before you commit to it, not after. |
Every project you run shows up on the Content page. That is where you check progress, read or edit articles, and change a project's settings. Each article usually finishes in under two minutes, so start the batch, close the tab and come back later.
Leave word count on automatic unless you have a specific reason not to. A set length becomes a target: the article pads to reach it, or stops before the topic is finished. On automatic, each article runs as long as the research supports. Some topics need 900 words. Some need 2,500.
MadWords comes with a No Edit Guarantee. If an article needs editing — broken English, a bad fact, a translation that misses, a measurement that did not convert — report it and we credit your account with replacement words. We read every report, because we publish MadWords articles on our own sites too. Read the No Edit Guarantee →
Write is for one article at a time, when you want a hand in it. It has three modes, and all three use the same research as Bulk Write: the top Google results for your keyword, their NLP keywords and entities, the questions people ask, and the facts in those pages.
| Write with AI | MadWords researches and writes the article. Before it writes, you check the plan: the Google results it will write from and the outline. Then you review, edit and publish. |
| Editor | You write the article and MadWords brings the research: NLP keywords, entities, facts AI answers like to quote, and the facts in the top results. Each one turns green once it’s in your article, so you can see what you’ve covered. |
| Rewrite | Pick a post on your WordPress site and open it in Write or the Editor. In Write, MadWords rewrites the article with fresh research. In the Editor, you get the same research data and update the article yourself. Nothing changes on your site until you click Update Post, and it updates the same post rather than adding a new one. |
| Keyword | The search you want to rank for. In Rewrite, it’s filled in from the post’s Yoast or Rank Math focus keyword, or its title if there isn’t one. |
| Related Keywords | Optional, up to 3. Adds their keywords and questions to the research. |
| Topic | Pick one and the article knows your business, products and audience. Leave it on None for a standalone article. |
| Language and Location | The language to write in, and where the Google results come from. Location starts on the United States. Enter a country, state, city or ZIP code for local results. |
| Article Type and Word Count | Review, Listicle, News, Comparison, Local, Explainer, Fix/Troubleshooting or How-to, and how long. Leave Word Count on Auto, for the same reason as in Bulk Write. |
| Images | 200 words each, with an Image Style and your own directions for the scene. In Rewrite, the post’s images stay where they are and new ones are added. |
| Products | Optional, up to 5. The first gets the most coverage, and in a listicle or review they’re ranked in the order you enter them. |
| Exclusions and Prompt | Products or brands the article should never mention, and any extra instructions. These are for Write with AI and for Rewrite when MadWords does the rewrite. |
Every article you write shows up on the Content page, the same as Bulk Write projects. Click Edit on any article and it opens in the Editor with the research it was written from, at no extra cost.
Write with AI shows you the 3 Google results it will write from, and the outline, before it writes a word. Untick a result that doesn’t fit, add up to 2 pages of your own, and change the outline. A minute here saves editing later.
When Search Console shows a post picking up impressions on page two, Rewrite is the tool for it. It researches the keyword again against today’s top results, so the new version covers what the pages above you cover now. Refresh keeps a page current a paragraph at a time; Rewrite is for a page that needs more than that.
Use Write for a handful of articles you want to shape yourself: a cornerstone page, a product review, a post you want to rewrite. Use Bulk Write for everything else. Same research, same quality, and articles from Write with AI and Rewrite come with the same No Edit Guarantee.
Translate your posts and pages into other languages to reach readers in other countries. You pick a language and a country for each translation, and MadWords writes it for readers in that country, not word for word.
| Topic | Select the Topic that has the posts or pages you want to translate. |
| Source Language | The language your posts are written in. |
| Translate | Ongoing keeps translating new posts as you publish them. One time translates the posts that are there now, and stops. |
| Type and Categories | Posts or Pages, then all categories (including new ones added later) or the categories you choose. |
| Language and Country | Pick a language, then the country you’re writing for. The country decides whose Google results we research. Click Add another language to translate into more than one. |
| Translation | SEO translation rewrites each post to rank in Google in that country, using the keywords people there search with. Direct translation stays as close to the original as possible, with no SEO changes. Use it for sales and landing pages. |
| Prices | Prices stay as you wrote them. Tick Show prices in the local currency too to add the local amount after each one, for example “$49 (about €42)”. |
| Images | Transfer your post’s images, add new AI images, or both. See Images in Every Language below. |
| WordPress Plugin | Download the free MadWords plugin from the Translate page and install it in WordPress. There are no settings. MadWords checks that it's installed before your translation project goes live. |
Every translation project shows up on the Content page, the same as Bulk Write projects. That is where you check progress and review what came back.
Text in an image doesn’t translate. A German reader looking at a diagram with English labels sees a page that was translated badly. So every image MadWords makes for a translation has no text, and one set of images works in every language.
Transfer images from original post copies your post’s images into each translation. If MadWords made one of them with text in it, like a labelled diagram, MadWords makes it again without text and uses the new one in every language, at 200 words per image, once per post. Images you uploaded yourself are copied as they are.
Add AI images makes new images for each post, between the minimum and maximum you set, so no two posts look the same. The same images go into every language, so you pay 200 words per image once per post, not once per language. Translating a post into 5 languages with 3 images costs 600 words for the images, not 3,000.
The alt text is translated into each language, so Google reads every image in the right language. Write and Bulk Write still put text in images where the style calls for it, like labelled diagrams, because most posts are only ever in one language.
Bulk Write produces one version of each article, so set your Bulk Write project to the language you publish in and keep it there. When you want other languages, use Translate rather than writing the same topic again in Spanish or German.
The reason is hreflang. Translating creates a linked set — MadWords knows which post is the original and which are the versions, so the MadWords plugin can tell Google which one belongs to which country. Two articles written separately on the same topic have no connection to each other, so nothing gets linked and your own pages end up competing.
Translation quality is not identical across all 95 languages. The most widely used languages — roughly the top thirty — come out excellent. The further you get from those, the more variable the results, and that is a limit of the underlying language models rather than something we can tune around.
So translate one page into your target language first and read it, or have someone who speaks it read it. Once you know it reads well, run the rest. If something looks wrong, tell us and we will see what we can do — but find that out on one page, not after you have translated a thousand.
Keep your content fresh by automatically rewriting one paragraph of existing articles on a schedule. Google rewards content that gets updated regularly, and Refresh handles this without you lifting a finger.
| Topic | Select the Topic containing the articles you want to keep fresh. |
| WordPress Category | Choose which category of articles to refresh. |
| Paragraph to Refresh | First paragraph, last paragraph, or one random paragraph. The rest of the article stays intact. |
| Refresh Every | Set the schedule — every 1 to 6 months. MadWords automatically rewrites the selected paragraph on this interval. |
Refreshes are made live. You can always go back to the previous post in WordPress.
We recommend every 3 months on your core content categories. It signals to Google that your content is maintained and current, which can improve rankings over time — especially in competitive niches where everyone else's content is going stale.
The article is only half of what makes a page rank. That was true before AI writing existed and it is still true now — none of what follows is a MadWords requirement, it is an SEO requirement.
Most tools in this category never mention any of it. Either they don’t know, or a magic button is easier to sell. We have spent years doing this work on our own sites, so we would rather hand you the whole picture than leave you to find it out after a batch of articles goes nowhere.
AI content ranks. Lazy AI content doesn’t.
Ahrefs analyzed 600,000 top-ranking pages and found 86.5% contained some AI-generated content — but only 4.6% were fully AI-generated. Google has been consistent about this: they judge the quality of content, not how it was produced. What gets penalized is scaled content abuse, meaning mass-produced low-value pages built to game rankings.
MadWords is built for the right side of that line. Every article is researched independently and structured differently every time, so your site never leaves the templated fingerprint that gets flagged. We didn’t release it until it matched or beat the writers we were paying, measured on click-through, bounce rate, time on page, and conversions. Read a few unedited articles → and judge that for yourself.
What follows isn’t here to rescue the writing. It is here because a strong article on a faceless page, on a site with nothing behind it, still loses to a weaker article on a site Google already trusts. The writing is our half. The page and the site are yours.
A name, a photo, a two-line bio, and a link to an author page. Google’s quality systems lean heavily on E-E-A-T — Experience, Expertise, Authoritativeness, Trust — and a faceless page with no author is the most common thing separating AI content that ranks from AI content that dies. This costs you five minutes and matters more than almost anything else on this list.
You can generate a lot of articles quickly. That is the point of the tool. Start with a handful of pages a week and build up as the site establishes itself. Slow and steady beats a firehose every time.
Brand new domains with no backlinks struggle to rank anything, AI or human. Content gets indexed, ranks briefly, then fades without authority behind it. You do not need to be a huge site — you need some real links, some age, and a few pages worth linking to. If you are starting from scratch, spend some energy getting known, not only on publishing more.
It also changes what you should be targeting. On a new site, go after long-tail keywords — three or four words, lower search volume, far less competition. Those are the terms you can actually win in the first few months, and early rankings are what build the authority you need to compete for the bigger ones later. The Keyword tool sorts by length so you can pull the long-tail set out and start there.
Google doesn’t only rank individual pages — it decides which sites are authorities on a subject. Covering a topic more completely than anyone else is how a smaller site outranks a bigger one. Use the Keyword tool to pull a competitor’s full footprint, find the gaps they have left, and write the entire cluster rather than scattered one-off posts.
Then link the cluster together. Articles on the same subject should link to each other, because that is what tells Google the pages belong to one body of work rather than sitting there as unrelated posts. Do it by hand for now — we are building a tool to handle internal linking across your whole site automatically.
Write some of your site yourself, or add your own experience into MadWords articles — a paragraph of first-hand detail, your own test results, a photo you took. Structural variation solves the pattern problem, but it doesn’t make a site of entirely machine-written content into something else. Google’s quality systems reward demonstrated experience, and experience has to come from someone who had it.
If you write about health, money, or legal topics — Your Money or Your Life subjects — Google’s bar is much higher, and AI without demonstrated expertise struggles. In those niches a credentialed author, cited sources, and human review are not optional. Treat MadWords as your first draft and your research engine, then add the expert layer on top.
Connect Google Search Console and give it a few weeks. It will show you which articles are picking up impressions and which queries you are appearing for — and a lot of those will be terms you never targeted. That is the most useful information you will get, because it tells you what your site can rank for right now rather than what you guessed it could.
23 unedited MadWords articles.
Read the articles →Everything included in every plan.
See all features →Plans, word packs, and what words cost.
See pricing →Write, localize and refresh with no editing.
Read the guarantee →Why every MadWords article is structured differently.
Why it is Google-Safe →95 languages and 138 countries, localized for each country.
See how it works →