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
6e97a4da064a26252394ae82235913ba1c40adba688dfffd54f548cec30b49dd536d9cd64b088ee5a482cf7def093c9647c55bf5c33e919506b83bb343d537e7895f6332f9197af43dc48b3d15f36b9e3dd9f955450e5bc577e5878cc082fccdd9d7cc8f723ba782cf2047d5bcae3121f4cb562304fffd2fb87128c268b90060bc74a86c88df1199b67e40c0a22903a88c729b92e9518297d0904d882932a82f99b230994fe2bb77b53bca3484d90e292d9160e9e70e1d281c8a037278f7986e9aa07501e96499b74d75362513f8682e4b59bf24782f5f09961b020b7755059555613c86f6f817176cd94f3d0c6e0979badac096c0c49bf4ed60d4c0f498193db05bb651ea3092cad529176eabe1b0608c89373e6faad063af9a574d927eb2cb2f124c17ed4b7705081c8ff81cc9ef23a13c09dcc5ff2cba747034bf98c1f4f8963b6cb48fd88826b8d5a75469eb85bec7b3ae30053611d26bd6f7fb591a7a584e91d8661a9322e2deb42134ecfa997e0364fa9711f8cbcd51c6bc70f6a0cb281b35a6cfdb6840d9ad8720f52007f86d050f0b7378c968bccbcdc1d93a1fb94ff3389c3a4163e53f7520a23b19e0f0170955acfb7b316fe93dc82605ba946d46d00ecd2df359d395d2badb91e072d3e2933855b95937a37d41805665e3a94cf349e54e0329e72f0b93e818973d9fc23ae6b6922775e974ca4a328fe8f78ffbbeb921937e0ce53da3238e0239b91ee7e6cc7fae3b1c5d376e6e9980d916fb5d17432134ca29e4e4446847d6b3ab68c20f76bb3906ffb61c97b98b3b69a5668f55c4132f02bf21d1f82585ca20dd14f46dce5b3ee3aa30f3b9b42c67c3e8d084378c5da0d369e4c6928ba153dc7a4c5252c79ea8377cb0afccd3bdeabd041bc719c099ca59aaedccefd14e4d74bd3a433d4147398c4f53218ab2650b4add59dda99d5e3459b23cb408b4fda0395de48fc8fa98be9e73a140d740a9a1dbf7ca189ac12a1011dae9f3f67f26a44e028324f6d330a5bcfb880037ee3541581e057f7e9edf1696d601f2f312753ceb5bc0d81b396df07b8b0ae74afcabb95d33e7d7a200ecc77d87bae7f6e9a5fac21d731dff7f57f9f14dee696318b0f7349b8ed534d49277cd3355cf2c26eedb4c7170d148acc881f54e355afc76355639336e0b7829f3095e0eba7cbdfaa2030852f2831afe663e5385f35cc79c56a0e1178b2ff38059b0638c5d08145f3d17c9c9b9ec27d6669fcfb5de77953edbd27973a01d689c6b3de91d2310b8361f3219115485c5374fc33caea6e9d269b36a9a7fc3726a81af121d30912aa2b5c212c482b083db61364acda361bdb8c54c9f2da0e0e22cc202fd894adaee71dbe23b71f7da2ab9fa85d456e2055c03463fe3fcd02538c72331866edb05273a0a58ef36a73f2ebf40bbeaa2b0461c3d3a7e9d391b96aacd59b3a37a01be012e3c9be277930b7d888a8f7fbbb07b1dcc5e1b252791e974eecf20cdb3414347b6a76c734f22a5872d557cc698152be2cae4f958898096d6e99056431bd4a971cb7140da00e602ad454b30201653b0da0884a858df39b009a36d6a6e52b94a24982d479bcf92f3ca368e375d8508438e8dfba403a83be660c2cd7a6b0c6b0bcb6475bce624ddb906320d9ec6afe3676cf119da13e5bdd10ad45a3acc48d7cc2ea97da067f4a435f1f8279fdef56faf4f275d04fe87768ceea0965d23b8fee53d68e232cb30912d35beea0b54f6465f7433320185653dbd7ead071acf1f348352d0dc94018d78949aa412802e055603d46b4aa8ead12ef8523265b32638fe543c4d83fd813498824603f95574eb81d774b0c03a8775effb214e07ef7c279136005457e079f036db0094123f0679e44259485b733488f4cca81a7afe0af4009592fc08f303ede608355a30030591883f455881c2c5501e79022b99f6fd4acec4ed48082266f67df89ab713610150eaa01bf0b8c6d050632f19af80c5c5fdf74d590248992cc9de2988987b2fc89d6c601c2f0b92c90d57b282d31a112833bf5a425014b1bed509891751888455a549f6775605b56e0123aadcd563288d78f7f2f0ba1ce3b9fcc666f4ac7f7bc3e619a16db28117d1f40d061a43628b99f5d2a8af4f0c23df97753c8729a63cfcd68a1cb35ba9dbbfb27d71762409e1c59e71f24e8f038bf3387d8c6aad3c56e10b6309185fa16771af02d704f92e883c2438f240cdcf637c3107d3a831557d03598e2e1f6f9ee72e23e09768f5372f2bb69954868cae3e777bbacaefd9785178e3b2ac248691a56e6867412d175740fe4a812e3f624f783754e46a0ca42f56ad5b365321184429a6d785b7bf248a9e51a98e892225df2763d9afba657e3a19e10e2f346bcac0271afc09b1ebadd23680d738fe988befa10c67854a36fe

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
a576dd5ef558ad73f83f44beff1bb78f31e22fa1972805d8758c266a5828e78c4ea26f3e7ef8f0247383665d01a1c6767bd4c14ac088be6691b8a7b1314862434dd6231dc9591faf6df1629fede46624bfbf3f8084576eaeafc204486d67e0368b14ef7c061288fab2ffdc98eacf60061f6a4592515e5ee0decfa71d51eb31d752e58d8e1ee234309a4079e9247e32bfda64185ac5da0c9a7497a0b0dec50469b8325ef56d79014a51102db7948d7359de93bb36398ce5e164bac39a8b15b15a2fecbdf1c0d540c44a4747889dc572a2136beb14140ef43572dae216c7638e144a5d425ca93202bdd76c6c3a190b19f53ee07902ab7821306301e0867189721205788b16e20f8815f96e90411dec5597c303b6b06481feece13f31f15c1c4f5ab8ca6d61a713a9c6b1b5c1b7abf0ec257129bae8df750f978f64c3fba351ac7e376259b070a89358a9415366e609bdd9c99522996c41349f06b3464ebc285317de90e9866f389d0a8712467217775b1ff8833ba31b138edf8b2f316a73116cdc8cdc8b20e8cc68f4753901aeca0acb0eeedbce2a327b9d761b4376ab3716acfd9e64dcec4e6f5816904ac74bb3c5843ddbc90df03676a4e040d256be660f7d2c7101a7fb516aedf271757121c858fd0da32ab2753f9a0a66c12547aabd990aa53a229aab9068795918f743f3fdb6edef5a0960d56a135f9de81da92034e775b3b443613c663bca369e2db036ee06546bf03f3bbbd681326eb1fd5185cf0621c7df1ae8897ef35d4eafae8489399145da1ec50dec26730ec147fbdc038c893a63e25c13a32439979dbc0dc158b101fc424ae4a6dadf14b731f572b50fe82dd0b6256e33ec1355e66d6c526886775017c9531ab9886e27e2a505029d1fc2b945debf0afa761cc24428a2386bf6f096a9bf355633b94d13601ec9a3f8c2b93d0d5c4bca60278a6dccb215e1d2a87f32a563786e77186f41ab92a4db87ffec1da1a750617c79dadec9bbb88289ba8d4645325787f207ba0774839bbdf592dc1ef1481e2b6e668057314752ed6c1a2f88d31459286df7fea48ef03480f1284e127bc34d598e8c589681261e530200a3a696d87e1ca57cc7a41ecdc20875b0d25ca0da85d588203c989169f3b9385b40aa652894ec49971c02e17f878f35e1249ee9bea5c50f08191317798f2534812af3195e0ccc9f50c7951543de8d7896e87717fabfb0d32939490f70f978795c6236094a1d4bb67096c91c0dba62daf543b1bb77c8cbdd36a3d16b1924964846a986ca483f4eb73faa7a4d7a8bf4dabd962f765dccad6e3351371eacba4e7efa3a1618a5a207a647841185df94bbd72017e540f5923f82009f6852aa14cb3c23517edf9919308c636080d91c940dfcef1fd3611d4e627d8395fd99cc178bbd198cb8586beddb21a3ae23ca3d24fec998235ff78471e129fefec3c102fa3ee5c71d74174fd53dce42091081125595b8716dc9f8294193dd4e2c05e490c78e10dd3f4c3325c77a09dbe278a7066ce649850f07a6e35e43a8f953a595b23cd4b6adfa4e3a17d5ff85653484eaa4aaf4fd8d2daa1796ca5dfca5c7da0f40ce333e48a02caa4dd7cd2f44de1f0ada245bb6815578cede79636c528c0c3480c4e9b5e9f9d6c34f54cc4648d558454bb4f8a589721b7b756b89fe1e64b2bb907e5386792d224de30e1fd49412ec30fbcda664ad8e78ff70e30adc0b7eef9ab40faad1ee8ab91e8b81a716e58ddf84b9173ebfa931eac0d99c32a558b245fde1fe7fa04b243d1284956b8863e39ddcaa6f8ee0aa648446b3c85517bc437f1903a0ec1b93cfaf7effafb880d49499392b0aae1fca0a0e4fb98334ff19d3671e70ab7f56454c8aabc82fedd7efbaa7526dc9818dce624d8190aaa2279a308d8534ac058258146058c9c9915d57adadbfbb3e9ad31229b36c23135850ca2929a87cdc26ad035b5815603b3e860283a7950b0efcb2f960cca0666597146d08277e81bf72a91027393dc3ce74ae016f801637fa826971cf788cbceb1cd0fc7c8efc82b19773906e26db16b5da65711faaacf8c0161b802859f8c9297446da7f5d1c86e1152cef9d0d40c91da8f3043259a6680f9493122d608d650b2027f6a94d86fc54e3bbe46ba0807cc579e87f5406718f85890a70d2e1c0dda9069b7129494f5e7ec33519830ae733a1dcd156f803b32b385dcb02b373134f66aac1f4a5a3883e9461d09490e53bb9e0aa9411a1ea2860b21aa18b7d55efff58d7026097427b71a10f034357125b65a707e990afe6acca2ce39adc743e0dc85bf5bc8960a125b4dff2e32adcd31e52fd08dd702b96742ea698c54433bc2d997dfb9d4d18627a6ad0c0c0a58628975111f432fa6875fd985965bee0fb720fd3f46792653019c21ea400cc5f9a66ba8118e95ed1751bf147d3ea0a3b2991b955f2ff62b8992801616306b244bbada55e45b20a2c65c94ee29661653b866c683c570a07ee43cb8cb4220a23463defbe0a64dfdbd77b5b438621e0c309e8e777e701468e95edca115566456fb7f216619443cd778841ab7e0e9a889d8297b0df519674e10840675ff9153f8b1bb1550d46bcbd918fdd2e87b67d10850a3ff177a9cf64b89119a8d6ea65aa4215b9f1f8978acac16e13ba3e81078092a4b2f81a20f58039a5b432bff3e4988bbe7259fde03bac5a63ffbe11834be2a9e0d27ae1020eb90c731fe6da999435a3cca24019d48aa63025e314411f70a799828969f07ecea63467f3aa4f1ea1276ff94557f97e64e364735bb41bc0bd31455f78541f87325b2ab33b57e6b633540fc0cac58f45b9275f0a7c458184815f21a3f35e031682dbf09b3eab04d532016e8bb417efc6c0160ed7cec7ce9cba05a0f6b78070c4b3a067a80804cdb6c0d9b39868ef80f1fbed5ce8e9d3a02ad247aaa35a138ede072ef8d24a14ae0a5739b08290e9ec43fef90224af1799e2f3c26eb6381533f6e8087a515a268bb00b7f112d855c0d6374f13c67acee069e1f8d0cfca077799e3d27a3247f9b7a057689048312f63e6d5f097e4c705ab6887b687c84f51d6957489826ac19b90aefa7bfb3d22a7d5253cac8eec4a62c1f76a3ddf0d6bf5d4ab0ae1fd1bbbfabae32ec33fd60c445037dcccc4a86eac20e1e60cd56b157a277f8f22f4cbbc058e4a14724645de6908a03a23d78c3f6cf2ceb008afaf08997568fea5ce6fa63cfd33f3a885b2bb99c534a76a4faf97e0934faed792cb58517057d7a6d9cb89a5595c40e2f52405a6f20271b6f0af10bc1d724a3e686f4310d765fea7baff054f3b03ceddc16869470d3b2b61f9fe87696c15abbf97792da43be142c622f3f908f818d0b661cbc7cc0ad52d06b3e8aacbac30c7b199b0569dde796f9787ac2ec44cf84c91fcd4a2f9911c55e2b17f782baf4cb895a0085604ad648aac39137d5590ce5390cfaa9504670f1302a6708e6fa90ec0afe95e13f1e7897746f495cb1c4b645ce31c2ce0ed80632c3c47ca269742f04e7e9cc8ecdbdb6f8c8d6915ba15b2bf87272ff9cca33b1eee958225e24e37c6048c4b71ffe0109712fc4b9754e892505eb48979048c760e611274f2ee7aba1e382d4d3899e429626eadddc645e6a914c18597f0a28e57737e869ad545cb46fd9b0f9fea79a3af0b8e99d4650dc2863ee283ac32ea893dc351058e6d41d8f65e45045984feab909dc868cd17f78c3fd6cc9f81eba57c82a58caa4bcf3511411388803e8637c508d04730e579c0c1cbcbaf024e2e1c05237565b5771aca6e2c42b86c444988d89312c2180634bd01476c28ced2428ad494e75c945dfd2899c49338b7e99773d3849de3b430a5c9c4435a62452efbaf4f31bc9cbb62550761ed6880e2751624f11895ea17ef8f87e6ec7a318aab6ee00b010d5e86510dc0d813ccd9b99558ab085fc7371ce4924e2113cb6b172dae429120ffbe28ebeae8e56534b293db008b7a40517a7885500008c54e378834f92c43e01f2d90ce47913ab694fa0026fecae350d216c6a907dd90ca760e9ed3c98ed9ce86f4e9b2458c450688cb07be36500886bc1303c3d54b9edc18f897df589bef73a50ef889730525dad2c4484924681f50d0e9607b0f1bca0e2387ab451d5428c1342417422edfcc7b5250f33c3b3777a70cd108f178d79d9fb87443cd5b8dc34b0ff1ec166f68183f6cda7509f82a1a8de0364ac01a1526bc7fcfbdf9bf2a93a66447be0b65cc15adf35b3b34c735f881f890a62e4bcaf8b61eed7dd1a9bf69cb27cde4e714dd752a48839c9bb42f72977eecd48eeb0d021c2ba0b727eca75df7c21759c6d87624b73e685efc869a79af3818e51782a29d6c5df1f98969585980ba00dcfa69680bd379fae943811cd0becbf2afd66f6af6881164a2e74f3683110a2ea7ae88dd0294ea83522112f705a4365f4afc38a672e77f7e443a7f14bbe3e5a0609e2c171cc904b59c61872636b7ab3506ceb53280f328de6d698271197dd9677b21bf75b529e981720d16ca24289583fc04f54fd7fa06b7d724ea254a5b90e674f673b6c58d71118d9d4e1ead5cc7172f4f121e73720169193d97ac189a99122f3cff9cf2839958a5396d59c7f2e0590b65680fd944811450bcda913542c0d63afe8070692d398b8f020f153aa69e0728c95d496037ed1f5433296c9129c8b0f77d99b93ef7aad5c3d359ff04cbbec96b6c772bb2f781b968fc6e6d4eb8d9c30cbfbbef0822e31564e718617df826b2153a5609c7a62bbdbe7d7ed986c7483af148533730fb86b7df069400c7dac4ccdb84bdf614d23254286c8cdc1b0ac93ab5984b2c2eb6cf9142421bcb0302e99eba16b0be2f4569734ce4c10d549832681f3bf98c890c98f74547c84b42243cce60ffcd9c74be9f4c79a8cdf92f76070c934bfaaabae511165e02bf532a50456be9e03bb9ea6d7fb8afe77b628f95781a38c22de348cb996449b1b18e27a83d4c4aac74b41cc05cff2c821abea1c67de16689ddc8622ba4a918bca3ba635fba3236eaf74a326de09c5cf91b93b34c3eb523834dce1328938283439e3f6f71d2c4750e0790470e96b992e71fbb543c45b17fdb62e25a1d26d8811f9c205236ce5de6405d8bd5efe563a8de8cee986c1d7e5a739c0972b3f7e927f82761068e8c4d950bac0ae94616c0acc34a8ba5c11e5adba8c7a5c8d7d0348a89e2543a9ce2c6d828df2046c9e8dd1e191d7fb85327fa9b428cba18f152d6e8dc38d936529342c6da75f68ea1d8fdbc4c059469c0775920427c23f63707686da62e21acb2ec808bde0f998795a99b6cc592ee80ac0148f6e9982ea56c4a8d6f50749591bb9ca2195da973c22ec8ec5f258b47e85ebd0dcfdeb1666193370de3f00bd1198fe4da8602059580aea1e88a36b1261dba5659c387a0ceb8f4673ed3dbae761ca5511253a673bb51221279876c86bede4f0126a5c238add2f1f4619ee94fc1e9d8a0a961e221a70b8b17415a896512a0031d44c387f2f8f2bf732737dc165def61334b3571d17981aaefe6fc5065ecc3dee2e3693b39bc2cb5d6f8860d891a3a9f7a6f969b21370da6052b922be0318d57f774c9ecc9a33d8504c61bb56cf189ef8207f98f406e0ac104522a2ccd84805c48ece2a159b5ed7b1fdc445e329c11278a37e8b96c51a770676cc819ed4c5de8118b57a1fe7da9cb22a3047aae0edc22ac87f29766a0a3ea9c960e106bba832e14f36660974246de97babefee83bb07a0bf579fffd8f58d6227121f5b1615ccb1124eab9e0656ff444f5daf25aa3640e3bd261b48dab35a8ec05163b695394a8aecb05ed76416a7583be4d677db345f1090bbad4ba947891e6999e5ce14f30595431fc3700bf21f82f9f9c316ece0d97ac070351eebb0d4e1be284d9493f8043a821a9932e1b97a6986b8256d28a4e87993a7fad13dc4ed795f2bcd77844a1bcd5b38323be9646d457f41adfee683e1b8325888d40332844fb57af0ff5bd9c3f113d415ce7be45e2a70362d20587a5f6aa6532f86686370499b493a796ef2a8ac0efc916b0dfcb89db2cd1c6bea1a8c0252d5ce5266d55a0c2c5b599a12b5ff1e750a68d8882562a50090ffcf717e23d4bf5371875bdc005008764aedfdf6179faf4980029d20a7f6c452d6a77ea6ac23f2457190a2a13749b176bff90b534668842326beb9518bae0e6c504245897db7ca3335b7a9f3dd85dc151c9850e106a2a8e50e01b52a92ee28d025e9367cb841327916e9f61b1e265d78f8b278e6fb13882b50e89f1c6a5fa1eb749ac464f3c76aed75d425cd1cd9070d1d4bd073ed918fc5c2791bb190a7e287fe65fcf63aa45b6ac84a7a2bf119f639852a50275297d7231eee2051c7ff4ad97592ab33960f136d00c36f9feba0f4361ec2cebc39fb51050a0e1b2a5bfc47416baa42af78320a0efa7edf0d4325939f0a62f5eae2a1298f6705f186aae8c5ca034e4990f701650da3f162992960c452f7e765fb6e15b4882646a10ae22f2d00d4e5d6745f7a14d1d409cebf97d8baae94c5b28facc81b8da258de972e9bf00358059f2bc0fdc2c97a8c371ad9a72f896ecc9c53765698

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