Uploaded image for project: 'Confluence Data Center'
  1. Confluence Data Center
  2. CONFSERVER-5876

Templates, layouts, user macros etc should be versioned and keep author information

    • 11
    • 3
    • We collect Confluence feedback from various sources, and we evaluate what we've collected when planning our product roadmap. To understand how this piece of feedback will be reviewed, see our Implementation of New Features Policy.

      NOTE: This suggestion is for Confluence Server. Using Confluence Cloud? See the corresponding suggestion.

      Confluence currently keeps only a single version of all of the textual configurations such as templates, layouts, user macros etc. This is very dangerous because if the user accidentally corrupts one out they have no easy way to get it back. Periodically a paniced email is sent to the Confluence mailing list asking how these files can be recovered. They can go through the backup/restore process but that is pretty painful and can take a while. It also doesn't help if a number of changes were made since the last backup.

      To get around this we have instituted a policy of checking all such files into a separate source control system. Any files that need to be changed are checked out, modified and submitted to Confluence. Once they work the new version is checked back into source control. This process is tolerable, but it is a big overhead for such a simple feature.

      It would be vastly preferable if Confluence treated these pieces of text as content just like pages, news etc. They could be versioned, you could see who edited them, you could see the diffs between versions etc. Since Confluence already has a powerful versioning system it seems like a no-brainer to use it for all the other pieces of content that are floating around.

          Form Name

            [CONFSERVER-5876] Templates, layouts, user macros etc should be versioned and keep author information

            David Peterson added a comment - - edited

            As the first commenter on this issue back in 2006, and since it is now officially an adult, cheers! 🍻

            David Peterson added a comment - - edited As the first commenter on this issue back in 2006, and since it is now officially an adult, cheers! 🍻

            7914a5fba7f8 - I'm finding ISO compliance to be painful in Confluence. Aside from all the changes they make and roll out without concern for controlled environments (yet their slogans are all about empowering "every team" - clearly not teams that have compliance requirements).

            On this ticket - firstly, happy 18th birthday ticket! Secondly, why is this not a thing? Templates of ALL things should be controlled with change histories.

             

            Trent Murray added a comment - 7914a5fba7f8 - I'm finding ISO compliance to be painful in Confluence. Aside from all the changes they make and roll out without concern for controlled environments (yet their slogans are all about empowering "every team" - clearly not teams that have compliance requirements). On this ticket - firstly, happy 18th birthday ticket! Secondly, why is this not a thing? Templates of ALL things should be controlled with change histories.  

            I can't say I am surprised to find yet another fairly basic request ignored. Initially, the (lack of) response here seems to align with Atlassian's apparent philosophy to reject requests for features that can be addressed via a workaround. I take issue with this philosophy but, for the sake of argument let's examine this request under the assumption that we philosophically agree.

            What solutions are being provided by templates that could not already have been addressed by a workaround? Essentially why should we use templates over normal pages? Currently, normal pages offer features like a page history, among others, while having few drawbacks compared to templates. There seems to be insufficient incentive for the use of templates. If templates do not have a sufficiently distinct use case, seemingly required by Atlassian's philosophy, there are two options:

            1. Improve the functionality of templates. Address the drawbacks compared to the "workarounds". There should be no downside when choosing to use templates. Then incentivize the use of templates with functionality improvements to distinguish them from normal pages. This would be preferable and I wish most requests would be approached this way, even if they do not all work out.
            2. Alternatively, remove templates and any other unnecessary or redundant features or functionalities. Do not waste any resources where there is no unique value. Redistribute the wasted resources toward the maintenance, improvement, and implementation of truly unique features. While this is not preferable, it is at least consistent and opens the door for more noticeable improvements elsewhere. 

            Connor Brown added a comment - I can't say I am surprised to find yet another fairly basic request ignored. Initially, the (lack of) response here seems to align with Atlassian's apparent philosophy to reject requests for features that can be addressed via a workaround. I take issue with this philosophy but, for the sake of argument let's examine this request under the assumption that we philosophically agree. What solutions are being provided by templates that could not already have been addressed by a workaround? Essentially why should we use templates over normal pages? Currently, normal pages offer features like a page history, among others, while having few drawbacks compared to templates. There seems to be insufficient incentive for the use of templates. If templates do not have a sufficiently distinct use case, seemingly required by Atlassian's philosophy, there are two options: Improve the functionality of templates. Address the drawbacks compared to the "workarounds". There should be no downside when choosing to use templates. Then incentivize the use of templates with functionality improvements to distinguish them from normal pages. This would be preferable and I wish most requests would be approached this way, even if they do not all work out. Alternatively, remove templates and any other unnecessary or redundant features or functionalities. Do not waste any resources where there is no unique value. Redistribute the wasted resources toward the maintenance, improvement, and implementation of truly unique features. While this is not preferable, it is at least consistent and opens the door for more noticeable improvements elsewhere. 

            Soon we are going to have a new generation adding to this interest

            Chan Fonseka added a comment - Soon we are going to have a new generation adding to this interest

            Concur.  Valuable enhancement.

            Amy Lasurdo-Patti added a comment - Concur.  Valuable enhancement.

            Davin Studer added a comment - - edited

            As mentioned above template actually are versioned it is just not exposed in the interface. You can see the versions in the database

            select *
            from PAGETEMPLATES
            where TEMPLATENAME = 'Your template name'
            

            For user macros I created an app that allows you to keep versions of the user macro. I also fix a bunch of other annoyances with User Macros. It's a free app.

            Enhanced User Macro Editor

            Davin Studer added a comment - - edited As mentioned above template actually are versioned it is just not exposed in the interface. You can see the versions in the database select * from PAGETEMPLATES where TEMPLATENAME = 'Your template name' For user macros I created an app that allows you to keep versions of the user macro. I also fix a bunch of other annoyances with User Macros. It's a free app. Enhanced User Macro Editor

            For ISO certified organizations and all organizations in regulated industries, this is absolutely essential. Templates require versioning, end of story. 

            Definitely going to weigh heavily in our decisions regarding whether or not to keep our company subscription to confluence.

            Eric Valero added a comment - For ISO certified organizations and all organizations in regulated industries, this is absolutely essential. Templates require versioning, end of story.  Definitely going to weigh heavily in our decisions regarding whether or not to keep our company subscription to confluence.

            Hello!

            We understand that it would be great to have Templates versions control features OOB, but if you are interested,

            we released https://marketplace.atlassian.com/1220906 (paid) plugin.

            It has simple options of templates versions control.

            Thank you

            Andrii Tkachenko [BeastieHut] added a comment - Hello! We understand that it would be great to have Templates versions control features OOB, but if you are interested, we released https://marketplace.atlassian.com/1220906 (paid) plugin. It has simple options of templates versions control. Thank you

            This really is a must-have feature to use confluence in a regulated industry like medical devices - we are required to have certain "document controls". And this includes managing versions of page templates. 

            Of course, this is not only required for these industries, this would also be a very useful feature!

            Jochen Neuhaus added a comment - This really is a must-have feature to use confluence in a regulated industry like medical devices - we are required to have certain "document controls". And this includes managing versions of page templates.  Of course, this is not only required for these industries, this would also be a very  useful feature!

            Chris Amos added a comment -

            I am a lowly space admin, no chance they are letting me near the SQL

             

            I can see one addin that does something with import/export, Template Ops, but it looks out of date, only says it supports v5. Anyone know of a v7 supported alternative?

             

            Chris Amos added a comment - I am a lowly space admin, no chance they are letting me near the SQL   I can see one addin that does something with import/export, Template Ops, but it looks out of date, only says it supports v5. Anyone know of a v7 supported alternative?  

              Unassigned Unassigned
              32356a7aaa27 Andy Armstrong
              Votes:
              259 Vote for this issue
              Watchers:
              124 Start watching this issue

                Created:
                Updated: