{
    "api_version": "1",
    "kind": "dse_post",
    "self": "https://update.dsesecurity.com/api/v1/posts/check-axis-overlay-slot-costs-before-adding-another-label/",
    "item": {
        "id": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/",
        "slug": "check-axis-overlay-slot-costs-before-adding-another-label",
        "url": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/",
        "alternate_urls": {
            "markdown": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label.md",
            "json": "https://update.dsesecurity.com/api/v1/posts/check-axis-overlay-slot-costs-before-adding-another-label/"
        },
        "title": "Check Axis overlay slot costs before adding another label",
        "summary": "Use the Axis overlay capability response to review slot capacity and the cost of text and image overlays. Do not assume that every visible label consumes exactly one slot.",
        "format": {
            "slug": "guide",
            "name": "Guide"
        },
        "priority": {
            "slug": "advisory",
            "name": "Advisory"
        },
        "featured": false,
        "image": {
            "theme": "physical-security",
            "label": "Physical security",
            "alt": "Integrated video surveillance and controlled entry at a modern commercial facility.",
            "card_url": "https://update.dsesecurity.com/assets/editorial/physical-security-card.webp?v=1.8.20",
            "hero_url": "https://update.dsesecurity.com/assets/editorial/physical-security-hero.webp?v=1.8.20",
            "social_url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
            "width": 2400,
            "height": 1350
        },
        "topics": [
            {
                "slug": "it",
                "name": "IT",
                "url": "https://update.dsesecurity.com/topic/it/"
            },
            {
                "slug": "video-surveillance",
                "name": "Video Surveillance",
                "url": "https://update.dsesecurity.com/topic/video-surveillance/"
            }
        ],
        "author": {
            "name": "DSE Security Editorial Team",
            "url": "https://update.dsesecurity.com/#editorial-team",
            "type": "Organization"
        },
        "publisher": {
            "name": "Detection Systems & Engineering",
            "url": "https://dsesecurity.com/"
        },
        "published_at": "2026-10-29T19:49:58+00:00",
        "modified_at": "2026-10-29T19:50:08+00:00",
        "reviewed_on": "2026-10-29",
        "reading_minutes": 3,
        "word_count": 526,
        "potentially_affected": "Axis products exposing the documented Overlay API interface; confirm actual device, hardware and software applicability before applying the proposed checks.",
        "dse_recommendation": "DSE recommends reviewing an overlay budget and ownership map before an application creates or removes overlays.",
        "primary_source": {
            "name": "Axis Communications — Overlay API",
            "url": "https://developer.axis.com/vapix/network-video/overlay-api/",
            "published_on": null,
            "authority": "Axis Communications"
        },
        "publishing_principles": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/",
        "usage_info": "https://update.dsesecurity.com/usage/",
        "copyright_notice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.",
        "content_html": "<p><strong>Bottom line:</strong> Check the device’s overlay resource accounting before adding another label or image. Review the reported costs and existing overlay identities rather than treating the visible item count as a reliable slot budget.</p>\n<h2>Source fact: documented behavior</h2>\n<p>Axis’s <a href=\"https://developer.axis.com/vapix/network-video/overlay-api/\" target=\"_blank\" rel=\"noopener noreferrer\">Overlay API</a> provides <code>getOverlayCapabilities</code> for the total slot count and the slot cost of text and image overlays.</p>\n<p>Its response describes <code>numAvailableSlots</code>, <code>slotsPerTextOverlay</code> and <code>slotsPerImageOverlay</code>, alongside limits such as maximum text length and image dimensions.</p>\n<p>An overlay receives an identifier when created; overlays may also be modified by internal applications, including overlays outside the ordinary text and image classes.</p>\n<h2>What the source does not establish</h2>\n<p>Do not assume the capacity field is a live free-slot counter without confirming its device-specific meaning. Do not remove another application’s overlay to make room for a label. Choose currently supported text/image options for the exact device, and do not infer a privacy-mask or image-quality result from resource availability.</p>\n<h2>Applicability questions</h2>\n<ul>\n<li>What capacity and per-type costs does this device return?</li>\n<li>Which existing overlay IDs belong to the affected application?</li>\n<li>What text length or image dimensions does the proposed item require?</li>\n<li>Which other applications or views depend on the current overlay arrangement?</li>\n</ul>\n<h2>DSE recommendation: controlled next steps</h2>\n<p><em>The following steps are DSE recommendations based on the cited source.</em></p>\n<p>DSE recommends reviewing an overlay budget and ownership map before an application creates or removes overlays.</p>\n<ol>\n<li>Retrieve the supported capability response and list the current overlays through the documented workflow. Record IDs, type and owning application where known. Keep the capacity values and item list separate, and ask the integration owner to explain how its resource budget is calculated. Mark an unknown owner as unresolved rather than treating the overlay as expendable.</li>\n<li>Describe the proposed label or image using harmless content. Compare its type, text length and dimensions with the returned limits, and use the documented per-type slot cost in the planning record. Avoid assuming an image and a text label have identical resource costs. Do not prescribe a larger font or image based only on a preview from another model.</li>\n<li>In an authorized pilot, add the approved item and retain its returned ID and operation outcome. Inspect the resulting overlays and affected views. Re-read the relevant configuration if another application changes an item during the exercise. On an unresolved resource error, preserve the existing arrangement and investigate capacity and ownership before deleting unrelated objects.</li>\n</ol>\n<h2>Verification and evidence</h2>\n<p>Retain the capability response, before-and-after inventory, proposed item details and its returned identifier. Keep permitted view observations separate from the resource-accounting worksheet. Have another reviewer trace any removal to an explicitly owned object rather than to its position in a displayed list.</p>\n<p>Use a proposed desk case with different reported text and image costs and require the reviewer to calculate the intended budget from those values. Label the numbers as fixtures unless actually returned by the test device. This article supplies no universal slot count, completed allocation test or permission to alter another application’s overlays.</p>\n<h2>Official references</h2>\n<ul>\n<li><a href=\"https://developer.axis.com/vapix/network-video/overlay-api/\" target=\"_blank\" rel=\"noopener noreferrer\">Overlay API</a> — Axis Communications; official VAPIX documentation.</li>\n</ul>\n<p>Source review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.</p>\n",
        "content_text": "Bottom line: Check the device’s overlay resource accounting before adding another label or image. Review the reported costs and existing overlay identities rather than treating the visible item count as a reliable slot budget.\nSource fact: documented behavior\nAxis’s Overlay API provides getOverlayCapabilities for the total slot count and the slot cost of text and image overlays.\nIts response describes numAvailableSlots, slotsPerTextOverlay and slotsPerImageOverlay, alongside limits such as maximum text length and image dimensions.\nAn overlay receives an identifier when created; overlays may also be modified by internal applications, including overlays outside the ordinary text and image classes.\nWhat the source does not establish\nDo not assume the capacity field is a live free-slot counter without confirming its device-specific meaning. Do not remove another application’s overlay to make room for a label. Choose currently supported text/image options for the exact device, and do not infer a privacy-mask or image-quality result from resource availability.\nApplicability questions\n\nWhat capacity and per-type costs does this device return?\nWhich existing overlay IDs belong to the affected application?\nWhat text length or image dimensions does the proposed item require?\nWhich other applications or views depend on the current overlay arrangement?\n\nDSE recommendation: controlled next steps\nThe following steps are DSE recommendations based on the cited source.\nDSE recommends reviewing an overlay budget and ownership map before an application creates or removes overlays.\n\nRetrieve the supported capability response and list the current overlays through the documented workflow. Record IDs, type and owning application where known. Keep the capacity values and item list separate, and ask the integration owner to explain how its resource budget is calculated. Mark an unknown owner as unresolved rather than treating the overlay as expendable.\nDescribe the proposed label or image using harmless content. Compare its type, text length and dimensions with the returned limits, and use the documented per-type slot cost in the planning record. Avoid assuming an image and a text label have identical resource costs. Do not prescribe a larger font or image based only on a preview from another model.\nIn an authorized pilot, add the approved item and retain its returned ID and operation outcome. Inspect the resulting overlays and affected views. Re-read the relevant configuration if another application changes an item during the exercise. On an unresolved resource error, preserve the existing arrangement and investigate capacity and ownership before deleting unrelated objects.\n\nVerification and evidence\nRetain the capability response, before-and-after inventory, proposed item details and its returned identifier. Keep permitted view observations separate from the resource-accounting worksheet. Have another reviewer trace any removal to an explicitly owned object rather than to its position in a displayed list.\nUse a proposed desk case with different reported text and image costs and require the reviewer to calculate the intended budget from those values. Label the numbers as fixtures unless actually returned by the test device. This article supplies no universal slot count, completed allocation test or permission to alter another application’s overlays.\nOfficial references\n\nOverlay API — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.",
        "content_markdown": "Bottom line: Check the device’s overlay resource accounting before adding another label or image. Review the reported costs and existing overlay identities rather than treating the visible item count as a reliable slot budget.\n\n## Source fact: documented behavior\n\nAxis’s [Overlay API](https://developer.axis.com/vapix/network-video/overlay-api/) provides getOverlayCapabilities for the total slot count and the slot cost of text and image overlays.\n\nIts response describes numAvailableSlots, slotsPerTextOverlay and slotsPerImageOverlay, alongside limits such as maximum text length and image dimensions.\n\nAn overlay receives an identifier when created; overlays may also be modified by internal applications, including overlays outside the ordinary text and image classes.\n\n## What the source does not establish\n\nDo not assume the capacity field is a live free-slot counter without confirming its device-specific meaning. Do not remove another application’s overlay to make room for a label. Choose currently supported text/image options for the exact device, and do not infer a privacy-mask or image-quality result from resource availability.\n\n## Applicability questions\n\n- What capacity and per-type costs does this device return?\n\n- Which existing overlay IDs belong to the affected application?\n\n- What text length or image dimensions does the proposed item require?\n\n- Which other applications or views depend on the current overlay arrangement?\n\n## DSE recommendation: controlled next steps\n\nThe following steps are DSE recommendations based on the cited source.\n\nDSE recommends reviewing an overlay budget and ownership map before an application creates or removes overlays.\n\n- Retrieve the supported capability response and list the current overlays through the documented workflow. Record IDs, type and owning application where known. Keep the capacity values and item list separate, and ask the integration owner to explain how its resource budget is calculated. Mark an unknown owner as unresolved rather than treating the overlay as expendable.\n\n- Describe the proposed label or image using harmless content. Compare its type, text length and dimensions with the returned limits, and use the documented per-type slot cost in the planning record. Avoid assuming an image and a text label have identical resource costs. Do not prescribe a larger font or image based only on a preview from another model.\n\n- In an authorized pilot, add the approved item and retain its returned ID and operation outcome. Inspect the resulting overlays and affected views. Re-read the relevant configuration if another application changes an item during the exercise. On an unresolved resource error, preserve the existing arrangement and investigate capacity and ownership before deleting unrelated objects.\n\n## Verification and evidence\n\nRetain the capability response, before-and-after inventory, proposed item details and its returned identifier. Keep permitted view observations separate from the resource-accounting worksheet. Have another reviewer trace any removal to an explicitly owned object rather than to its position in a displayed list.\n\nUse a proposed desk case with different reported text and image costs and require the reviewer to calculate the intended budget from those values. Label the numbers as fixtures unless actually returned by the test device. This article supplies no universal slot count, completed allocation test or permission to alter another application’s overlays.\n\n## Official references\n\n- [Overlay API](https://developer.axis.com/vapix/network-video/overlay-api/) — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings."
    },
    "json_ld": {
        "@context": "https://schema.org",
        "@graph": [
            {
                "@type": "Organization",
                "@id": "https://dsesecurity.com/#organization",
                "name": "Detection Systems & Engineering",
                "alternateName": "DSE Security",
                "url": "https://dsesecurity.com/",
                "logo": {
                    "@type": "ImageObject",
                    "url": "https://update.dsesecurity.com/assets/dse-logo-20260812.png?v=1.8.20"
                }
            },
            {
                "@type": "Organization",
                "@id": "https://update.dsesecurity.com/#editorial-team",
                "name": "DSE Security Editorial Team",
                "url": "https://update.dsesecurity.com/",
                "parentOrganization": {
                    "@id": "https://dsesecurity.com/#organization"
                }
            },
            {
                "@type": "WebSite",
                "@id": "https://update.dsesecurity.com/#website",
                "name": "DSE Updates",
                "alternateName": "DSE Security Knowledge Hub",
                "url": "https://update.dsesecurity.com/",
                "inLanguage": "en-US",
                "publisher": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "potentialAction": {
                    "@type": "SearchAction",
                    "target": {
                        "@type": "EntryPoint",
                        "urlTemplate": "https://update.dsesecurity.com/?q={search_term_string}"
                    },
                    "query-input": "required name=search_term_string"
                }
            },
            {
                "@type": "WebPage",
                "@id": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/",
                "url": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/",
                "isPartOf": {
                    "@id": "https://update.dsesecurity.com/#website"
                },
                "lastReviewed": "2026-10-29"
            },
            {
                "@type": "BreadcrumbList",
                "@id": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/#breadcrumbs",
                "itemListElement": [
                    {
                        "@type": "ListItem",
                        "position": 1,
                        "name": "DSE Updates",
                        "item": "https://update.dsesecurity.com/"
                    },
                    {
                        "@type": "ListItem",
                        "position": 2,
                        "name": "IT",
                        "item": "https://update.dsesecurity.com/topic/it/"
                    },
                    {
                        "@type": "ListItem",
                        "position": 3,
                        "name": "Check Axis overlay slot costs before adding another label",
                        "item": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/"
                    }
                ]
            },
            {
                "@type": [
                    "Article",
                    "TechArticle"
                ],
                "@id": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/#article",
                "identifier": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/",
                "url": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/",
                "headline": "Check Axis overlay slot costs before adding another label",
                "description": "Use the Axis overlay capability response to review slot capacity and the cost of text and image overlays.",
                "abstract": "Use the Axis overlay capability response to review slot capacity and the cost of text and image overlays. Do not assume that every visible label consumes exactly one slot.",
                "articleBody": "Bottom line: Check the device’s overlay resource accounting before adding another label or image. Review the reported costs and existing overlay identities rather than treating the visible item count as a reliable slot budget.\nSource fact: documented behavior\nAxis’s Overlay API provides getOverlayCapabilities for the total slot count and the slot cost of text and image overlays.\nIts response describes numAvailableSlots, slotsPerTextOverlay and slotsPerImageOverlay, alongside limits such as maximum text length and image dimensions.\nAn overlay receives an identifier when created; overlays may also be modified by internal applications, including overlays outside the ordinary text and image classes.\nWhat the source does not establish\nDo not assume the capacity field is a live free-slot counter without confirming its device-specific meaning. Do not remove another application’s overlay to make room for a label. Choose currently supported text/image options for the exact device, and do not infer a privacy-mask or image-quality result from resource availability.\nApplicability questions\n\nWhat capacity and per-type costs does this device return?\nWhich existing overlay IDs belong to the affected application?\nWhat text length or image dimensions does the proposed item require?\nWhich other applications or views depend on the current overlay arrangement?\n\nDSE recommendation: controlled next steps\nThe following steps are DSE recommendations based on the cited source.\nDSE recommends reviewing an overlay budget and ownership map before an application creates or removes overlays.\n\nRetrieve the supported capability response and list the current overlays through the documented workflow. Record IDs, type and owning application where known. Keep the capacity values and item list separate, and ask the integration owner to explain how its resource budget is calculated. Mark an unknown owner as unresolved rather than treating the overlay as expendable.\nDescribe the proposed label or image using harmless content. Compare its type, text length and dimensions with the returned limits, and use the documented per-type slot cost in the planning record. Avoid assuming an image and a text label have identical resource costs. Do not prescribe a larger font or image based only on a preview from another model.\nIn an authorized pilot, add the approved item and retain its returned ID and operation outcome. Inspect the resulting overlays and affected views. Re-read the relevant configuration if another application changes an item during the exercise. On an unresolved resource error, preserve the existing arrangement and investigate capacity and ownership before deleting unrelated objects.\n\nVerification and evidence\nRetain the capability response, before-and-after inventory, proposed item details and its returned identifier. Keep permitted view observations separate from the resource-accounting worksheet. Have another reviewer trace any removal to an explicitly owned object rather than to its position in a displayed list.\nUse a proposed desk case with different reported text and image costs and require the reviewer to calculate the intended budget from those values. Label the numbers as fixtures unless actually returned by the test device. This article supplies no universal slot count, completed allocation test or permission to alter another application’s overlays.\nOfficial references\n\nOverlay API — Axis Communications; official VAPIX documentation.\n\nSource review completed October 29, 2026. Recheck the official documentation and the deployed device’s capabilities before changing production settings.",
                "datePublished": "2026-10-29T19:49:58+00:00",
                "dateModified": "2026-10-29T19:50:08+00:00",
                "mainEntityOfPage": {
                    "@id": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/"
                },
                "inLanguage": "en-US",
                "isAccessibleForFree": true,
                "author": {
                    "@type": "Organization",
                    "name": "DSE Security Editorial Team",
                    "url": "https://update.dsesecurity.com/#editorial-team"
                },
                "publisher": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "image": {
                    "@type": "ImageObject",
                    "@id": "https://update.dsesecurity.com/updates/check-axis-overlay-slot-costs-before-adding-another-label/#primaryimage",
                    "url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
                    "contentUrl": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
                    "width": 1200,
                    "height": 630,
                    "caption": "Check Axis overlay slot costs before adding another label"
                },
                "articleSection": [
                    "IT",
                    "Video Surveillance"
                ],
                "keywords": [
                    "IT",
                    "Video Surveillance",
                    "Guide",
                    "Advisory priority"
                ],
                "genre": "Guide",
                "about": [
                    {
                        "@type": "Thing",
                        "name": "IT",
                        "url": "https://update.dsesecurity.com/topic/it/"
                    },
                    {
                        "@type": "Thing",
                        "name": "Video Surveillance",
                        "url": "https://update.dsesecurity.com/topic/video-surveillance/"
                    }
                ],
                "wordCount": 526,
                "timeRequired": "PT3M",
                "publishingPrinciples": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/",
                "usageInfo": "https://update.dsesecurity.com/usage/",
                "copyrightHolder": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "copyrightNotice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.",
                "citation": {
                    "@type": "CreativeWork",
                    "name": "Axis Communications — Overlay API",
                    "url": "https://developer.axis.com/vapix/network-video/overlay-api/"
                }
            }
        ]
    }
}