An add-on for Google Docs

Numbered headings, without the retyping.

TidyHeadings numbers Heading 1 to Heading 6 as 1, 1.1, 1.1.1. Add, move or delete a section, run it again, and the numbers are updated. You see every heading before anything is written.

Try it on a sample document

Coming soon to the Google Workspace Marketplace.

  • Free, with all features.
  • Opens only the document you use it in
  • Writes nothing until you click Apply

After Number headings

Service agreement

  1. Heading 1: 1Definitions
  2. Heading 1: 2replaces typed number 1.Scope of services
  3. Heading 2: 2.1replaces typed number 1.1Deliverables
  4. Heading 2: 2.2Acceptance
  5. Heading 1: 3replaces typed number 2.Fees
  6. Heading 2: 3.12026 ratesyear kept
  7. Heading 1: 4Term and termination
  8. Heading 1: Signaturesunticked, not counted
  9. Heading 1: 5Schedule A: price listcarries on
A contract that gained a Definitions section at the top, so every typed number was one off. Highlighted numbers are the ones TidyHeadings writes; struck ones are typed numbers it replaces. Worked out by the add-on's own numbering code.

Try it on a sample document

This runs the numbering code of the add-on itself, the same file, here in your browser. Change the options, untick a heading, edit the headings, then click Apply. Nothing you type here leaves this page.

Sample document

Field study report

Title style: not a heading, so it is never numbered.

  1. Heading 1: Introduction
  2. Heading 2: Background
  3. Heading 2: 1.1 Scope of this report
  4. Heading 3: Out of scope
  5. Heading 1: 3. Method
  6. Heading 2: a) Data collection
  7. Heading 2: Analysis
  8. Heading 1: 2024 Results
  9. Heading 1: Conclusion
  10. Heading 1: References
  11. Heading 1: Appendix: survey questions
TidyHeadingsDemo

11 headings, 10 will change

Untick a heading (for example References) to leave it as it is; it is not counted, so the numbers after it carry on. The headings under it stay as they are too.

  • 1 Introduction
  • 1.1 Background
  • 1.2 Scope of this reportwas 1.1 Scope of this reporthad a typed number
  • 1.2.1 Out of scope
  • 2 Methodwas 3. Methodhad a typed number
  • 2.1 Data collectionwas a) Data collectionhad a typed number
  • 2.2 Analysis
  • 3 2024 Results
  • 4 Conclusion
  • Unticked: References
  • 5 Appendix: survey questions

This is the review for the sample document, worked out by the add-on's numbering code. Turn on JavaScript to change the options, untick headings and try your own.

The demo shows Heading 1 to Heading 3; the add-on numbers down to Heading 6. In Google Docs, the number is written into the heading text, in the heading's own font and size, with no highlight.

How it works

For long documents with numbered sections: specs, contracts, policies, reports, theses.

Numbers
Heading 1 to Heading 6
Styles
1, 1.1, 1.1.1 or 1., 1.1., 1.1.1.
Starts at
Heading 1 or Heading 2
Leaves alone
Title, Subtitle, Normal text, headings in lists and tables
Permissions
This document, and its sidebar
Price
Free, with all features
  1. 2.1

    Use heading styles

    Give your section titles the Heading 1 to Heading 6 paragraph styles. TidyHeadings numbers those paragraphs. Title, Subtitle and Normal text are left alone.

  2. 2.2

    Open it from the Extensions menu

    Choose Extensions > TidyHeadings > Number headings, or Remove numbers. Both open the sidebar with the review ready. Open sidebar lets you set the options first.

  3. 2.3

    Check the review

    Choose where numbering starts (Heading 1 or Heading 2), the deepest level, and the style: 1, 1.1, 1.1.1 or 1., 1.1., 1.1.1. The sidebar lists every heading with its new text and counts what will change. Untick any heading you want left as it is; the headings under it stay as they are too.

  4. 2.4

    Click Apply

    Only now is the document changed, and only the headings you left ticked. The sidebar then tells you what it did, and reminds you about the table of contents.

Edited the document since? Run it again. Headings that are already right stay as they are, and the rest get their new numbers.

What it changes, and what it leaves alone

An add-on that edits your writing should be predictable. These are the rules TidyHeadings follows.

3.1

Only the number at the start of a heading

TidyHeadings deletes the old number and inserts the new one. It never rewrites the rest of the heading, so links, bold text and comments there stay as they are. The new number takes the font and size of the heading text, and is never part of a link.

3.2

Only the document you open it in

When you install it, Google asks you to allow two permissions: to see and edit the document you open it in, and to show its sidebar. It cannot open any other file in your Google Drive. There is no server: your document text is never sent to us or anyone else.

3.3

Nothing is written before you click Apply

The review only reads your headings. Your document changes when you click Apply, and only the headings that are still ticked. Unticked headings are not touched.

3.4

It stops if the headings changed

If the headings change between the review and Apply (you kept typing, or someone else in the document did), nothing is written and you see: The headings changed since the preview, so nothing was changed. Click Preview again.

The permissions, and what little we keep, are listed in the privacy policy.

Questions

Not answered here? Email support@tidyheadings.com.

Does it update my table of contents?

Not by itself: Apps Script, which Google Docs add-ons run on, cannot refresh a table of contents. After you click Apply, click the table of contents and choose Update, and it shows the new numbers. The sidebar reminds you.

What about headings inside lists or tables?

They are not numbered. The review tells you how many there are, for example 1 heading in a list or table is not numbered.

My headings already have numbers I typed by hand.

TidyHeadings recognises typed numbers such as 1., 1.2, 2), II. and a) at the start of a heading. Those headings are marked had a typed number in the review, and the typed number is replaced by the new one. Untick a heading to keep it exactly as it is.

Years and other numbers of four digits, as in 2024 Results, and a number followed only by a space, as in 3 Methods, are read as part of the title and kept.

Can I undo it?

Choose Extensions > TidyHeadings > Remove numbers. It takes out the numbers TidyHeadings wrote, and typed numbers it recognises, after the same review, so you can untick any you want to keep. A typed number that was replaced earlier does not come back.

Does it remember headings I unticked?

No. Every review starts with all headings ticked, so untick References (or any heading you keep unnumbered) again when you renumber.

What if my document skips a level?

A Heading 3 straight after a Heading 1 is numbered 1.1.1, not 1.0.1.

Which numbering styles can I use?

1, 1.1, 1.1.1 or 1., 1.1., 1.1.1. Numbering can start at Heading 1 or at Heading 2 (then Heading 1 is left as it is), and you choose the deepest level, down to Heading 6.

Does it work in documents with tabs?

It numbers the headings in the tab you have open.

What data do you see?

We see none of your document. TidyHeadings runs inside Google Docs under your own Google account and sends nothing to us. It can open only the document you use it in, and does not read your name, email address or other files. The privacy policy has the details.

What does it cost?

Nothing. TidyHeadings is free, with every feature.

Support

support@tidyheadings.com

We answer within two business days.

If a document came out wrong, tell us what its headings looked like before and after, and which options you chose.