Understanding patterns

Patterns are layouts that you can copy and paste into your theme to instantly change the look-and-feel or behavior of a page.

They’re built on our powerful micro-templating system, which means they can be copied from our Pattern Library and pasted anywhere in the help center, giving you unparallelled flexibility and control.

While page templates can only make use of the objects and helpers available on a given page, patterns can render markup based on help center data (categories, sections, articles, topics and/or posts), custom data you pass to the template or data from third-party services. Our status indicator patterns are an example of displaying third-party status information from Statuspage.

System status in a badge
View code
ab644d0117be2dc74d1435d3b2b5b7a4de27adda05de2d6fa59ac7e672ee6cdbab1617f1219d96ab10a32613e8d3e8ad98b0eaac01edbc0ccabc114954933e70563b0d47561d7b0907304e849b09b1ab8e3602b0c9f2d3945df823a7dd3686eaca55c54f4d298a330c9206f19001687432d5341d24648e783099f997027d9dd71f38e02e5d6d0c46b67f312fdbbb53b46551ad9dbae99f128c592b23bc9968429909770bcc2b0d108c0b66dff7c4d6968c44e16f3305225a49b730cbba92c46779f0200a18a538d53d62fd7bbc668f302a9c6d483c05b9ab012532e347641cf33723536916222b5684838daf71e9d00c3756851afc0fa309cc5f86f33f0b3ab286d0da718aa784a40fbf09f721e180244b3817bf8210491c949731f685ed9e1626968974ddf5597ca7e70036e13d62a8052cd0a5482a60f94d09cd1ff1863ec5178988ae952ec1e35890c3664fd631b4b943d57a6baea37fc50a4cbb53775b6e5ae89c7d6b0c2b417f27ee10b9ab977ab7c9f3b3d30708f6c40adeffe3576aba98befb40c98a9ba745dfd98e86f7a65c257bce60cb8db42afa0ff917a27159e887fd81384018136f27744aede9730fb2b35a1e7535d4ad5ff0d0b97a905e1c022ecc5c60793b92a30786e1a31eba8dcc3f2dce28d2297f4d4e2b825db585693c600d5a428de4c7bee9d2f777068f9aa5a8966649bf887f5dcf42ef6d316a64d24b661a4c6359c8fca149749dc2c125a9dd9201a5d7fca2be4f8ceac958aa5f4ae0261ce46a55b1ce36162aad4601df6f1e6c948659170e63ef53ac490ff14decbbad6fc15b1656b3b0b601e2c80221c831873357e37b74fc5170e8b452eb389f57c5b195ca303def8c8e32af433af33376f8abed8221d5d5cd8e765aa5d458e65b6e98075e7357972cb9678d0ed5530d651e5deb9b1c52234de1b81b3639b09d7b7a53a520af735b8daadbef9904f774319fd6cd624fa81b14e365941167a96c634c4bf2ffb3e3a06353e95c695f2873365c6ab69bd87ced1f6e82a6e85445e765916eff82fdf3a8481093db8a9353b880f9f72a104f8837ece9cedf057a00d2301d4e680df850e741799b2de47f06e077787f3ec9dccf83f7fec81e0b59513faf97e6fa9eadfcd23c26b8715931c8c61c327260b3aee557625c954828511e2b3ed8d9d4e73902e50b742a2233b023376321c213f34b2a969fcbfc797b4c4c910833927584637197aad9c9e6539f56ce647575814555542d4ea9683be3de6a98f30dc88f45a9c5192b0eb02df3a059ba4a7cf9dc7c984153581b0bfba1f5bf7c2bdaed76ecb674123ca9a9a37b6c81404b521780a5b8b7bbb5674276fee85ecab07c528ea627b117e1e780f5024d86d56a6e1723f7d6170ea0440db6491bf4857fdf416061210b7be7e82fd8ca769e6997f90804d23e5e0786a22ce3105ccce52cf2cb65db95343fa882ff7c68c955cf77e567f6c0a18deffb17b901c8a724ee86f321a571346779fbe4a393cf6ac83fa962974bb636a2f49021d45b84a07c74b7807d5176eefd9313a8b30cdb0d9da58f0e10e33bb1529a529a8509b042c5e74551aada7831bd20e2443f14dbdd7bde840e545a2f7a8331803ad0c356a446a06ec3d639099d22b935af4519503f4cd16634fe3c6d0fec0ae75fc15c1e8325c0eefc6763873f58969a93b58536b7d3aa6f00cad6ab2493986e8461734f6b2d9d41dcc25efe27882c427626480a281f02414c73532dd01b3aeaf021296fe69e7e13f2c57dcea70d6d59ea591ca215e754ef31d11cc24e5c42f742b7ce4fccde607ea395106d88acc1f36ffb36c61da311eac2acfffc5e6baa0861a89653b7442871b90b08abedee686ecf65dc02acbc02ad0835de2e58226e09bb36bab14357777fd4fa42358800a5838511f2ab278f242912e93c963dffe65db2cbde883f8b0a97d8525acb24931cb77e6c8e8f50cfe740df7b15236e4c0a93a0c74d41035cf8c0d5cb6e1a4bfcd21ab8644a476c2551f9872d030c589c56372dfa055a4fb404c525ac7cb2cc0f1a5c2f9a3fdf598374d2647360146ab40bd0cc6d29d01ad9d3e8d70e287895209c982a1aeffb9c31f136dae6f449f258eae64b76ef0cb248fff2b9770e7c3410f9216be34aca44830463ea6081b10fbc0adc3708ec458eca03f6909b1c1848ca1704388eae3450ad1d518225f51a98768e14e5ca847669eaca29c94b6e3c90cf1d639da057ef461cf69eb274c980cb38db3f3dc7521bb074763bcd4369d2be3ba6a4430914f68bf77eceaf5c52a5f1859ab89fce2c097d9fb8c9cfd6d50cad3cf985f5aa01200e4c34f06c096870e2996cd1e2bedbd5e7753bed3c848cc261bb4c86b74e47648cda1d4f693b471bac62fbcfac4198053c680fbde4edd8716b31ca0e15228bafd886ae

Flexible, dynamic layouts on demand

Patterns are not limited to specific pages and you can use them to add layouts and functionality that doesn’t already exist. Our Recent Articles extension, which allows you to display a list of the most recent articles from across your help center, is an example of this.

Most recent articles
View code
a24b70c242c4ad7e9dd6ee46cc1c597e4b35c00201cf960fc219950932e773662c7dc60e008e24609f7b2ba1c027cf794512277e07500098e1102c112a4556ff09faf1e31c1c3943b0c1b7cd6effff546e57ac4d5df8d131fa8999e382b57e325e702ce1e38b668a5efd3f9269803b798703399add5920d8a12a89efef99e68cb2cc2f01346f35d1c65cbf2e76914ad7c48b50aa0f25f5ffbd2f4e8b403ca2f46b7f68e36d9919a54350f4486e81254b9489c4bad34a05906b78aae92c0953a46ba5a6b422ce04a98779830d39c30dd31a0f39dc140bab0bac9dd754bcdbf3fb9a43f97d4680460d2933ed9dec77ec21a3609269e7abdeb98c9a7efdc79677d982b1983b4b76d4a2efb27125e5e0a8a3699f2b37af8091c17446c1827fe7341f28ec1fb621c818c0d145f8916d851b89be72d4dd99da114198a04efd38ec8f31fa2563992a2c4c365c0eb0bf84243d4911962b0a2a761289453f912e9c40f2aab17ece472ee5e7c7487f212a6fe038087a47f97606bcd610d4a47e68a38b9fd1ad9009563637bff3214739a8ed811bf47ba78e2fed0f49d6c2d68f44e6d40ad232fdc28c8b4d16dd2a429e808c7e91f7f51b59b9901b3805b6f79100daff6de3b6cc84b435bfd35659e16ba9c173fc6ae681459ccc1baa21783b4d5ad6188f2ea81e23f7fb77d8580ef1ae579a674ea0a35cae3480f361c6f6c3c927078736cee00afed2c0101713d7817ee1e67369e9fccb992a12eb90f04d4ff40ffa89c51640cd0ecc96f71529646fb625c73c226a3f4b060e2cfa2ecee7684ceb9b9cb495141e01324bddd3d0f943ce1fab3e2860d6aace15dc4bd43ff4da53b948c497711422e2c1e22bc8e31068d3de4330da7fd6e779eb3da0c5602c8002e7f7149088153d96e42012e4df7eb17b9a63b3b86ebcefdb2a6e9c3184c64743153873c88208e2e61d7667ad1e59cfbbe1ac0bb84ad8f3c9f5110e079b019c6318f8b262e3f655763d7502fd87a8384a2ca69946d16c2146d7df4f7754eb12b74396c32276cf4cfefd16cf93c65d99ffa0dbff5217006430b49b53132e77fd7707cf4cefee765c3733b4f083c25bbbdb01d4dc74ade45f3c673d33c6aeaa89b2b7b3c302c9da323d0a4946ea469168aa683b5fe1c865804628255193bc756e73fd468e70b87a7f7d34e140e82b198fab0775daeaee80e017707008b0d694d0becd468a62819e432a4ab3010b2015322a6a9b68f6752b4fe30a9a139581301c16b49a35cf6c05747b5580a29448a17be0345572edcfe91dcd7f15141dc15edede55bad01f868749ee209d1afa8a241aa91a01584a0d73f4ba47826f5234a9209b09693da0643d88f94cc75f2666a7930e6f4625236946238c7ccfe4dc48f2cc0713d48eabddece71adfa6fbf611f60af9bb8391ef6a9fe5613177544b1fc48892041f564bbf8b486355d149402d0af628c92799bcfb511bf5a3339a5c3996aa4e05ce99ca99861dfbb4cb6112dfcb557b751ff0593e505f831ed844facc2b68d1242c7e26041ed28290b8aadb4a0f07d318e130ce2b212bb051e447befbb2b1677fa9c1c6894f363e3297e6a4b33a2998405e95bb79c1ff59e439794c07b78fcb076d03b33c3e0114a0155af6554408fb8b1bc89b868e2050ffab0ad3f5e676918eb450d779300b4b40879b54cb4c5e4efb6b691ec7e79fc7358477c9dfa914fd883da39dd7330b32f77d4b6f6c0fb5421bd7659697c28c8509627a62fa40f1eb71ae35645f2f3b5c79e930d229cbb2b9d4a625e1462926416fd9bb7c0d27d79dc59b5bcd6e1383fe5a1e0751b0334ffde61fa13ebfb3e76bc156bc581085cdaac91e0d5bd56202259f108609e2865c86c92525d8497274d066f6d0d91cafc2674f371fdcba97a6dfa6642d50145aaf2d95b18623392742f6f759dc8ba773f1bd67b7bf8cd5fd1146a5ef0329e67e0bf93f3700e0f5c73494a69ac149c93cdf3aa3d0884ec3c787ca53f570db937a8b68ebcbd8111c7e434e39637b51dd23895654342105ed970ab56d9f7b40198cf9494534e69413a6221a05c938bca84c3195070b50eea2d31c8e3f347bf8b256b6eea99db60050909acbf32052faa2c6e517730a254cda7fea8e68223476944542de2c5b75c057414c48ee078500afc49d80d674ea0e59d4eada231c78adcda96c4a990307567a313718f705184f4a40de7c89abfff031ac8f07464755a21d4e7b1f377640e51a5dc5947049373a50f910288a71398eb37e2fca69a2e380908a74c026b622f725027e4fea0b4f315ed21f9fec80c93777a63a74fa4b794fc822baec3c66634a6176763a24af6cae3eae97c6808589a78b325621087267327169a6695e9731799b6cfdc01d14a7e0bf1397152a69ed2e638c23971daae2eb9718618ee898a23f1328426dd5b96f40dd3be4f6094d64fa3b1ad130195473a95e68814ddf4e0984c94985cbac038801275b11616bc3167b181e7953465d3dbf32fb78096b5c8e7a062aca18458981f7228e3400ba00e27cebe4fdd2c272e3e64e2126d708e86f03f9306a64cd72d8f9eb50fc69fc9f6d257a5579e75f5f9c223c70065010f1822d541c5e42d0658a0f0f83c874ac1ccb45e35875a393c690f5ef53cb9a4da7b81ab38ba3b7f654fed9666624f127a28895bece4b8d089c5734ec01aa0e85a44445ff679ae5100f1fe9d4ac57fdb5c8e2dff7db14d07725b349ef0aca5003629156542aebcf6a352a982e6afe0e1c3271f5da079db9645489968f17bb8879f9acf1495cfc799e6eea47b7074a60b924c1b13df450ce8eb622361296d8d9750a6246b8ed2febab73ddbffd6978a67f58325221abc8c9b79af90d69893112cf73af2c4283c341659843257f8f2263fb27e513e2d1956d5e492d23242989cede9798551838625f595b76ad470026013d1ce91492b1a4fb97442af7b1b1c3dbe32d982aa752ed865e81e645db9257c2de50add1bf7c9a24d88cd3e1acf5097c0b46e09f5673bbb29bac6400a4b6460c931ea96312056bac1a6c47d73a55fb5decc438fa98684732a2f9beefa690fa0c8c51be8a1e652ffd4c1eca88eebf92a963f75d998945b861c1d0906e7e3733b97f56b8573dec27e4fabe66eb4b0c8f433ff9ed97ffd10f0bf4f0fa044b63152d1ab9c95849e58b27f5b6c50672b7548461f0c71b10db5b1ac10d6cb3c7016f92040fcb21eeed3dc779a7459c06eef2b17774c4b31b309da4bef41469ad48c72afa7e381fd9a3853455df5571744a283e6d52d0c1ff45019e77a7d6a028b5513964e4482f126a77bf1cbdfc1f862fa585111aee9b1f4c512549ea2444c358a2a5def77e631c77a3bfe3fbaec1e39a908ee7ebbca294e0e0e365676e3af9e2b7c75916c5ea4560173656f3d88c572edf3605875ef4c0ad04873c79f17d206996d46661260d6b6ab08db2c846cb4fba7789703003b0c889cbe1c49b095deaf94d76d7c30e268e1179649f3999a6c27864e334969d2c386c6fb1ed137d330a927235f1e1da74b71539c3d23006c417296f4851fd208b3888b6d63ea1885661410661ed42ab9168e3dd4925c575bf362a7f5e9b2fe2d260da66c0fc41cdcc4f51583257315f31ddbe4d1440d15963a9e7b55f8f4167ac3ed36ac429a8ebe4ad0c1d8b4fbb9c741ef9d0d0df88b70f152d5696c6983576ad5ed0aa34c23907f2ee15e343c8a1105dcda25b2674f9c2e4fccc4a6dec958275f15fcf3ea8ee3f29354fd3ba1b2a04f5504540b88f0324f78136eec32b8ee2fcf58064c7b4e3059e0c21e1c26d6d62bcf82de9a8c576ca0b22aee5dea310fa5360b3389dbef505498b4413078efddb9c69117cc2b13e97119962c8c30e4e7dae1f4a6450e28b73d95d86a87c11a3bf731440ff635645cd513162ec4f63a6d0e222be73a410aafc3673ac4ce30d25f11a63ddc330390a258b7c68f658cecd334e6fbaeee660d8aa54a3dc26f0dfe7f967df1770b4a8392b35b15882263c98fe605993be0e301a602b84f82791e82d2662d172e3a8e4bf81e7896c870060c70a65380556186a534a3cb52b6149cc1951b2c5113c21490f6f54b011cf0f25e27f662f37c50f2977731428571f1a3fbe701daed8a06a4dd814c8de0a6465154fee3cd3bbda6fa2d31f4a35009c57d559acc9e3b438cef50000fef5428f919aeb96717aad9c43eab53677edc64d58eef9f0bd3a6a37fd713ec25263219449ef4cd9367b4147809aad00d2c74a0c312231fced6b500a3cafa679ba64ea2e22384f3d57b1d60a981686d357dbf0488047b4f2dcde427f26bdecbc422ae342069e61915a150cb760cde48a8c9f86ffcaac9344ebc21c3e3baa779d6eb398ce8690b362777a1036484faef00755b74dd2af3e4b264056846f13a60b2ab1188f5d7700ecdc90b581c7cdc27d3f0fc378ad59cb80d4c54574bada0b0893685db471df776dbde635839393cb60eec20e65811913a720fab69d8d5e2735c153af60c8c64df090b5e40a24bbec3564d3adb392b80e5f475e3be0bbe22c477e0ee2447faa3b86456b787ca87f485b9b29e5a4a4f32aefd1d6309916b29da25ff534c7f71943ed4ca2736fa4f05d2492749df742d6a324fc23bbf79cfa8f198cad6653d0dd0e654303ef196ce577ff0d06d14e938b5a5d4a83b8dcb4eeace40ef10c872771f876b234f4f868ef44546eed66f167b05d297c3eaec3d00f6c897f23141e7f547b6c515e537ebca34687b9d03d9ba86a6f30272b5d9007b327ebcf6d935b3e1d30dcfa1141487ca0b4f7b7dbdf4cf9c6f4234157c15402d741529415c4ffe36fd14d65fc842031e55be4e99605979789db684948a350eb82a183651281abe0592f010de1ea933da34020433a31694c20653517976067fe3719d71ef7ac436010fb67f61be7af261900352b8888e971726125c2e6059295212e461ce48e58c5f85a528881bcdf8234f2729aa5e0e5b7520eba63a2673feddd46b57ddd5834197fa0084209e13af0c749f0142282d01a554c992b70303af09a8e5601a6ae15a3d62c9f2f6f6127046f1cd9967fab41531bc6a31d2cfe2c44c11c903e865ac7e1895eaeb4b88a25802bbf82b629fef56e4ea95f53f4a47a36f4b8e0257cb9fda115864227c2e0b982fcecfa59952ef70b87e72e339ef0fa799c90c94a41329a0ea5a9091cfe158317a6fa889c7a82a75ea8e4788814c620d1e89277257148722d964cc200d6eb87d5cc46b75e7c3199acf657fb00ed762c398b55c816cb6eae80aff0355858d5995aa9a35c5ac364cf8dd1c7f953826fbcba4452d78b0d9c3d47702a10fcf97e4db49549994ed2ecd143ae9e629e3717955ec98f9492bca3f49728623a0da47e25a01266ea92785f7bbbc62b8fcef81e519696e1b230be229aed13e8ab4acc07a930394c8eb9859b8cf240165fb2102848bc5e06f7b074386dd0b0ad80f64f5b59d05fbf1fab1d5aa3ce53a7b2962ddf1005675d33d19fa70779d36b26af53c7731f7a0c6654713fb1793f420199166a5c74b610cb652131bc766abd2ec025aead9d6d8158d8c472deb2f52d19d847e06822dcd9fd637353f5afeac80bda25d38c4ddea3f01bcd65d4192c680b144af765dfb6069a1d73e93811431fe0f0d46dfcd00b8d7db7f123f3f1d65dbe826fcd5190f126846e83a58cc9ff77307208df77a17062d17dd98ad950a99c0cea36c21b5d1c6578befbdaef55e7f6cfe44cfa0090e08d03093893ee5b3b46cfaf1670027ae5be9fc688d5a1e61df63e07c6b3fdb312baa77a9a1d0d7e906b6f8669d229ec0bad998cbd85c5e69b9055a76646cc13abb05952278ed286726921fb6f81c8a825895ae926325ee19a601dbadd4b4ead03176b56199f8cf16aa84b37c39b8f2a6fc915043c31cd647739dfc99cdc57d5d896400605aa0832693246c37d8ba7fa5aad36aff94175352198327b516f1eb2d34bbf62934c4998597889f52231e9e71a6db5730beaa33ce5daaa44ef5852fe45a55a852ff47ae8b557aa0787852272a7a24cb588e7e4e1afd72205d878b16b8f29e8b175e67d825fc4678bb4c297a33edca5bbd313f8f943df16bc9c96a269c2371eab9481a9177cfff12a5adbd82e9329cc08acb126610557db568ac2ad82c2af2e8881d9638a317b4af975805d47fc2588f40231a93b94300fb665e8d504ec62b842008e92c58883c7f574471ddcbf102fb749421c1f76e9e3bf6710dfd9cae9d616ec4db5e618f8cb1c8c2153909688c414cbc3e35abf0732b5edcfafb70c50eaafd691c7e6dcca884278fbd60d2d7a92c38b801cb428b19d5913dc2fa23202be2dfbfd6b4e9a5070b50e4c1be1e990aff878078912079dca8b8f2bfeea1021625d3fdd525be741389bb5435b5978506d9be6a9d8f35529ec4bc1f1bad33387cd463165038adfce78ce9ae0a196687eba52ebfa9f8d084be9e576b7c911aeeed4f5f9b3afb50d6ddde583b21cb8d1cdf7a2069427c36029b4c350399c4a54177c468fdce5b7e5f0de7681ef3c0ab741a47129b1dcbca5b4daf898a8cf8c51412e267434f824c3e01bc98b03224c9d160440288e28be995d45a4

Our themes also come with many configurable elements, like content blocks and table of contents elements, which you can customize using patterns. The look-and-feel and even functionality of these elements can be completed changed by copying a pattern from our library into the theme as described on each pattern’s page.

Because patterns must be copied and pasted into your theme, you must have access to underlying templates. To get complete access to the theme source code you can purchase:

  1. The Developer license through the Zendesk Theme Marketplace; or

  2. A single theme or the Complete Package through our website.

Questions or feedback about this article? Let us know