Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
namePage Info
id278129461
classwatermark-layer
Content Column
namePage Body
width100.00001%
id278129463
Content Block
background-colortransparent
namePrompt
id494677873
classtight manual-prompt-flex

Set up a document identifier to be automatically assigned to page titles in a space.

Content Block
nameOutcome
rich-link-hoverstrue
id1042866408
classtight manual-outcome-flex

Replace me with a more complete explanation of what this how-to accomplishes.

Content Block
nameSteps
rich-link-hoverstrue
id494842117
classsteps-block numbered manual-steps-flex tight-bottom

Open the Confluence Sidebar and click "Space Tools"

You must be a space or system administrator to perform this action. If using Brikit Theme Press as well, toggle open the Confluence menus to access the Sidebar.

Select "Overview"

Navigate to the "Apps" tab

Click the "Document Identifiers" sub-tab

HTML Wrap
classdocs-screenshot

If you haven't done so, click to "Enable Document Identifiers"

Define your Document Identifier

Set a Code and Pattern according to the rules and examples in the right-side informational section. See the Note section below for this same information.

HTML Wrap
classdocs-screenshot

Click Save

Document Identifiers are now set up. You will be presented with a summary table of your document identifier.

Take note the special short URLs

A special shortcut URL is created based on the document identifier. You may use this URL to directly access the pages using these IDs (and bypassing the titles). This can be an extraordinarily handy way to reference documents quickly and easily simply by its ID.

Create a new page

For every new page created going forward, a Document Identifier will be added to the Page Title according to the pattern and sequence defined.

Note that the Confluence Page Title does not actually get changed in the Confluence database, so you will not see page identifiers in page titles in the Confluence Sidebar. That said, Document Identifiers are added to the Confluence search index, meaning you can search Document Identifiers to locate a page

Additionally, if you have Brikit Theme Press, Document Identifiers are included in page title listings in the Navigator and in macro results.

HTML Wrap



Content Block
nameNote
rich-link-hoverstrue
id495965127
classmanual-note-flex
collapsiblecollapse
Note

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.
Content Block
nameTip
rich-link-hoverstrue
id894522670
classmanual-tip-flex
collapsiblecollapse
Tip

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
Content Block
nameWarning
rich-link-hoverstrue
id894530759
classmanual-warning-flex
collapsiblecollapse
Warning

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
Content Block
nameInfo
rich-link-hoverstrue
id894537203
classmanual-info-flex
Info

Document Identifier Pattern Options

The following special characters may be used to define the document identifier:

  • N - Display document number. Multiple N's will left pad with zeros. (e.g., NNNN -> 0001)
  • A - Convert numbers to a single, uppercase character. (e.g., 1 = A, 2 = B, etc.)
  • a - Same as A, but lowercase. (e.g., 1 = a, 2 =b)
  • All other characters will appear in the document identifier unchanged. See Search Optimization note below for pitfalls.

Pattern examples (all reference same page in tree):

  • NNNN.NN.N => 0002.02.3
  • NNNNa.a => 0002b.c
  • NNNN-vN => 0002-v2
  • NNNNAa => 0002Bc
  • Aa.N => Bb.3


Search Optimization

Because the Confluence search engine separates text with spaces and hyphens, to get precise search-by-document-identifier results, spaces and hyphens are not recommended within document identifiers.

For example, use -NNNN.NN instead of -NNNN-NN in the Document Identifier Pattern field below.

A document can be found by searching for the document identifier ("DOC-005.01") or using the document: prefix ("document:DOC-005.01").

Content Layer
background-color$lightGrayColor
nameRelated
id888168050
Content Column
nameRelated
width100%
id888168051
Content Block
rich-links-hide-descriptiontrue
rich-link-hoverstrue
rich-links-columns4
rich-links-verticaltrue
rich-links-image-height100px
rich-links-hide-site-icontrue
rich-links-details-padding10px
nameRelated
rich-links-enabletrue
border-width0
rich-links-details-alignmentleft
rich-links-margin20px 30px 0 0
id496234544
classrelated-block clean manual-related-flex