{"__v":1,"_id":"5859743ffb96101b000d602c","category":{"__v":2,"_id":"561c7271d2fb350d004bf89a","pages":["561c80a3a2cc000d00e9a861","564de2b5b5bea52b00c3457b"],"project":"561c70aabe5fb20d00077758","version":"561c70aabe5fb20d0007775b","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-13T02:54:41.501Z","from_sync":false,"order":4,"slug":"settings-other","title":"Settings & Other"},"parentDoc":null,"project":"561c70aabe5fb20d00077758","user":"5825dece55b1060f00ec4134","version":{"__v":6,"_id":"561c70aabe5fb20d0007775b","project":"561c70aabe5fb20d00077758","createdAt":"2015-10-13T02:47:06.824Z","releaseDate":"2015-10-13T02:47:06.824Z","categories":["561c70abbe5fb20d0007775c","561c725c4b0a9b0d00c0f515","561c7260cd5e7b0d00eb48c6","561c726bf0e0580d00ddd9a4","561c7271d2fb350d004bf89a","564de219b5bea52b00c3457a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":["59087be1ed5f240f0041d6fd"],"next":{"pages":[],"description":""},"createdAt":"2016-12-20T18:11:11.933Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"Carnival allows you to pause push notifications. Pausing is particularly useful when you are delivering pushes to a large audience and you want to manually suspend and resume sending push notifications.\n\nDue to the speed of our platform, pausing can only be effective with audiences of at least 100,000 devices. If you want to limit the rate at which notifications are sent, refer to [Throttling Push Notifications](doc:push-throttling).\n\n## Pausing a push notification\nWhen you create a push notification, its initial state will be **Scheduled**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/33ebb79-s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480450706268_ScreenShot2016-11-30at9.17.54AM.png\",\n        \"s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480450706268_Screen+Shot+2016-11-30+at+9.17.54+AM.png\",\n        594,\n        130,\n        \"#d4d9d9\"\n      ]\n    }\n  ]\n}\n[/block]\nOnce the push has been processed and is ready to be sent, the state will change to **Sending**. A progress bar will appear to display the current progress within the audience (in other words, how many pushes have been sent so far).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9d20205-s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480451349237_ScreenShot2016-11-30at9.28.57AM.png\",\n        \"s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480451349237_Screen+Shot+2016-11-30+at+9.28.57+AM.png\",\n        590,\n        126,\n        \"#d3dada\"\n      ]\n    }\n  ]\n}\n[/block]\nYou can now pause the push by selecting the pause button. This will instantly set the state to **Pausing…**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/95697ee-s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480452043576_ScreenShot2016-11-30at9.31.41AM.png\",\n        \"s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480452043576_Screen+Shot+2016-11-30+at+9.31.41+AM.png\",\n        585,\n        132,\n        \"#d5dada\"\n      ]\n    }\n  ]\n}\n[/block]\nIn this process, Carnival will determine if the remaining audience size is large enough to resume a send. If that's the case, the status will change to **Paused**, otherwise the push will complete.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a42148e-s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480452591242_ScreenShot2016-11-30at9.49.33AM.png\",\n        \"s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480452591242_Screen+Shot+2016-11-30+at+9.49.33+AM.png\",\n        586,\n        132,\n        \"#d2d8d8\"\n      ]\n    }\n  ]\n}\n[/block]\nWhen your push is paused, you will see a progress bar to indicate how many pushes have been sent so far. To resume sending, simply click the play button and the status will change to **Sending**.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/912bb8f-pause.gif\",\n        \"pause.gif\",\n        1140,\n        290,\n        \"#eff0f6\"\n      ]\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"push-pausing","type":"basic","title":"Pausing Push Notifications"}

Pausing Push Notifications


Carnival allows you to pause push notifications. Pausing is particularly useful when you are delivering pushes to a large audience and you want to manually suspend and resume sending push notifications. Due to the speed of our platform, pausing can only be effective with audiences of at least 100,000 devices. If you want to limit the rate at which notifications are sent, refer to [Throttling Push Notifications](doc:push-throttling). ## Pausing a push notification When you create a push notification, its initial state will be **Scheduled**. [block:image] { "images": [ { "image": [ "https://files.readme.io/33ebb79-s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480450706268_ScreenShot2016-11-30at9.17.54AM.png", "s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480450706268_Screen+Shot+2016-11-30+at+9.17.54+AM.png", 594, 130, "#d4d9d9" ] } ] } [/block] Once the push has been processed and is ready to be sent, the state will change to **Sending**. A progress bar will appear to display the current progress within the audience (in other words, how many pushes have been sent so far). [block:image] { "images": [ { "image": [ "https://files.readme.io/9d20205-s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480451349237_ScreenShot2016-11-30at9.28.57AM.png", "s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480451349237_Screen+Shot+2016-11-30+at+9.28.57+AM.png", 590, 126, "#d3dada" ] } ] } [/block] You can now pause the push by selecting the pause button. This will instantly set the state to **Pausing…**. [block:image] { "images": [ { "image": [ "https://files.readme.io/95697ee-s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480452043576_ScreenShot2016-11-30at9.31.41AM.png", "s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480452043576_Screen+Shot+2016-11-30+at+9.31.41+AM.png", 585, 132, "#d5dada" ] } ] } [/block] In this process, Carnival will determine if the remaining audience size is large enough to resume a send. If that's the case, the status will change to **Paused**, otherwise the push will complete. [block:image] { "images": [ { "image": [ "https://files.readme.io/a42148e-s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480452591242_ScreenShot2016-11-30at9.49.33AM.png", "s_DC0E39F8CF186979669011F5141DDF5507D95C6101CAB33DF47C2D7A1C383768_1480452591242_Screen+Shot+2016-11-30+at+9.49.33+AM.png", 586, 132, "#d2d8d8" ] } ] } [/block] When your push is paused, you will see a progress bar to indicate how many pushes have been sent so far. To resume sending, simply click the play button and the status will change to **Sending**. [block:image] { "images": [ { "image": [ "https://files.readme.io/912bb8f-pause.gif", "pause.gif", 1140, 290, "#eff0f6" ] } ] } [/block]