Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Excerpt vs Synced Block

Manuel Kroiß
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
March 26, 2026

Hello Confluence users,

 

Can someone tell me whats the difference between

  • /excerpt and /excerptInclude
  • /syncedBlock

 

We are validating the usage of those features and I don't really understand when to use what. What are the advantages/disadvantages of each.

 

kind regards

Manuel

1 answer

1 accepted

5 votes
Answer accepted
Kris Klima _K15t_
Community Champion
March 26, 2026

Hi @Manuel Kroiß 

The idea is the same, execution a bit different.

For starters, blocs are easy to track both ways (source <> target). They are easier to use, you simply copy past a bloc from the source to the target page. With excerpts, you need to track incoming/outgoing links.

Blocs also work in Jira (Jira - Confluence).

It's easy to turn a piece of content into a reusable bloc.

Managing the use of synced content is easier.

However... Where I found limits was in blocs' compatibility with marketplace macros and apps. Some apps can't process blocs content yet and/or you cannot place them into blocs. Some native Confluence macros might fall short of blocs compatibility too. So do test it.

I would also appreciate a wholsale management - for example, in Content Manager a column with 'synced bloc source' would be nice. In databases, you can display an excerpt that's on the page (only the first one...) but that's something. The last time I checked, there was no such option for blocs.

Hope this helps at least a bit.

https://support.atlassian.com/confluence-cloud/docs/create-and-use-synced-blocks/

Barbara Szczesniak
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Champions.
March 27, 2026

Thank you for the warning about this new feature not yet being compatible with marketplace apps, @Kris Klima _K15t_ 

Even though these new features have not yet been rolled out to my instance, once they are, I will put off using them until they are supported in Scroll Sites.

Kris Klima _K15t_
Community Champion
March 27, 2026

@Barbara Szczesniak - we're investigating the options. I think this goes for all marketplace partners.

As a writer, I'd very much welcome integration with Scroll apps.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PERMISSIONS LEVEL
Product Admin
TAGS
AUG Leaders

Atlassian Community Events