Back to News for Developers

Better Open Graph Stories with Flexible Sentences

January 3, 2013ByMax Miao

To help people share better stories, sometimes you need to customize the syntax of the Open Graph. Today we're launching flexible sentences, an advanced feature that lets you modify sentence structure and build richer stories.

In certain instances, the default sentence structure may be awkward or lack context. For example, previously, if a person indicated that he tracked an artist on Songkick, a concert-finding app, it was not clear why.

With flexible sentences, Songkick is able to provide better context by adding words to describe what happened.

We've also updated the configuration tool to show the most frequently used story formats so you can prioritize those requiring adjustment.

Most stories will continue to be worded properly without needing to use flexible sentences. This functionality is only available for custom actions and will not work with built-in actions, which are intended to provide a consistent experience across all instances. If you modify your existing actions, you will need to resubmit your actions for approval via the App Dashboard.

Flexible sentences is available today for developers, and we're beginning to rollout the new story formats for users. To learn more about working with flexible sentences, please see our documentation.