The prepared square covers 3.3 × 3.3 inches. The finished circle is 3 inches in
diameter, centered in that square. Keep faces, names, and other important
content inside the centered 2.5-inch important-content circle; extend the
background to the square’s edges. This product has no paper option.API clients supply the exact prepared JPEG, including an embedded RGB color
profile, or use compatible template-render output. A larger square photograph
does not satisfy the exact prepared-file contract. Automatic photo preparation
in supported storefront checkout flows is separate from public API prepared
asset validation. Historical revision 1 references remain unchanged.
⌘I
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Batch Relay API","colors":{"primary":"#2563EB","light":"#EFF6FF","dark":"#1D4ED8"},"logo":{"light":"https://media.brand.dev/e0f13cde-5756-4d8b-bfdf-01f76e6b0d41.svg","dark":"https://media.brand.dev/e0f13cde-5756-4d8b-bfdf-01f76e6b0d41.svg"},"navbar":{"primary":{"type":"button","label":"Developer Dashboard","href":"https://app.batchrelay.com/developers"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ftrbnd","hasAudioNarration":false,"actualSubdomain":"ftrbnd","customDomains":["docs.batchrelay.com"],"gitSource":{"type":"github","owner":"sentinelite","repo":"batch-relay-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeafa19e84fb046db8b4cad","collectionId":"ebcb1da7-627a-4689-b011-49bbfab55ee5","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeafa19e84fb046db8b4cad"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aeafa19e84fb046db8b4cad","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Reference","count":165},{"language":"default","tag":"Guides","count":33},{"language":"default","tag":"Studio Operations","count":26},{"language":"default","tag":"Studio catalog","count":18},{"language":"default","tag":"Core Concepts","count":16},{"language":"default","tag":"Product reference","count":13},{"language":"default","tag":"Consumer printing","count":13},{"language":"default","tag":"Studio management","count":12},{"language":"default","tag":"Studio offers","count":11},{"language":"default","tag":"API accounts","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"products/photo-button-3","slug":"/products/photo-button-3","pageMetadata":{"title":"3-inch Photo Button","description":"Order one 3-inch button from a prepared square artwork asset.","href":"/products/photo-button-3"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Order one 3-inch button from a prepared square artwork asset.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`photo-button-3`}),` revision `,_jsx(_components.code,{children:`2`}),` produces one 3-inch button per quantity and supports\noptional template artwork.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Required asset`}),_jsx(_components.th,{children:`Exact ratio`}),_jsx(_components.th,{children:`Required prepared pixels`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`artwork`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`1:1`})}),_jsx(_components.td,{children:`990 × 990 at 300 DPI`})]})})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"product\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"photo-button-3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"revision\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"quantity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"assets\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"role\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"artwork\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://cdn.example.com/orders/button-art.jpg\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pixel_width\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`990`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pixel_height\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`990`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"dpi\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`300`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"format\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jpeg\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The prepared square covers 3.3 × 3.3 inches. The finished circle is 3 inches in\ndiameter, centered in that square. Keep faces, names, and other important\ncontent inside the centered 2.5-inch important-content circle; extend the\nbackground to the square’s edges. This product has no paper option.`}),`\n`,_jsxs(_components.p,{children:[`API clients supply the exact prepared JPEG, including an embedded RGB color\nprofile, or use compatible template-render output. A larger square photograph\ndoes not satisfy the exact prepared-file contract. Automatic photo preparation\nin supported storefront checkout flows is separate from public API prepared\nasset validation. Historical revision `,_jsx(_components.code,{children:`1`}),` references remain unchanged.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"3-inch Photo Button","description":"Order one 3-inch button from a prepared square artwork asset.","href":"/products/photo-button-3"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"ftrbnd","siteName":"Batch Relay API","title":"3-inch Photo Button - Batch Relay API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T08:12:49.498Z","originalFileLocation":"products/photo-button-3.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Order one 3-inch button from a prepared square artwork asset.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Batch Relay API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/ftrbnd/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/ftrbnd/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/ftrbnd/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/ftrbnd/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"3-inch Photo Button - Batch Relay API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Order one 3-inch button from a prepared square artwork asset.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Batch Relay API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.batchrelay.com/products/photo-button-3\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ftrbnd.mintlify.app/_mintlify/api/og/v2?division=Product+reference\u0026amp;title=3-inch+Photo+Button\u0026amp;description=Order+one+3-inch+button+from+a+prepared+square+artwork+asset.\u0026amp;theme=182a8e84995dd9358c2ea7e4\u0026amp;signature=7e39c25bab3646350ad7d873a6bfb1fe62dde32de847844f2b188b15b2c3500c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"3-inch Photo Button - Batch Relay API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Order one 3-inch button from a prepared square artwork asset.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ftrbnd.mintlify.app/_mintlify/api/og/v2?division=Product+reference\u0026amp;title=3-inch+Photo+Button\u0026amp;description=Order+one+3-inch+button+from+a+prepared+square+artwork+asset.\u0026amp;theme=182a8e84995dd9358c2ea7e4\u0026amp;signature=7e39c25bab3646350ad7d873a6bfb1fe62dde32de847844f2b188b15b2c3500c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/ftrbnd/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Batch Relay API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.batchrelay.com/products/photo-button-3\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/products/photo-button-3.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.batchrelay.com/#organization\",\"name\":\"Batch Relay API\",\"url\":\"https://docs.batchrelay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://media.brand.dev/e0f13cde-5756-4d8b-bfdf-01f76e6b0d41.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.batchrelay.com#website\",\"name\":\"Batch Relay API\",\"url\":\"https://docs.batchrelay.com\",\"publisher\":{\"@id\":\"https://docs.batchrelay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.batchrelay.com/products/photo-button-3#webpage\",\"url\":\"https://docs.batchrelay.com/products/photo-button-3\",\"name\":\"3-inch Photo Button\",\"description\":\"Order one 3-inch button from a prepared square artwork asset.\",\"dateModified\":\"2026-10-19T08:12:49.498Z\",\"isPartOf\":{\"@id\":\"https://docs.batchrelay.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.batchrelay.com/products/photo-button-3#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.batchrelay.com/products/photo-button-3#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Product reference\",\"item\":\"https://docs.batchrelay.com/products/prints\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"3-inch Photo Button\",\"item\":\"https://docs.batchrelay.com/products/photo-button-3\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.batchrelay.com/products/photo-button-3#article\",\"headline\":\"3-inch Photo Button\",\"name\":\"3-inch Photo Button\",\"description\":\"Order one 3-inch button from a prepared square artwork asset.\",\"url\":\"https://docs.batchrelay.com/products/photo-button-3\",\"mainEntityOfPage\":{\"@id\":\"https://docs.batchrelay.com/products/photo-button-3#webpage\"},\"dateModified\":\"2026-10-19T08:12:49.498Z\",\"publisher\":{\"@id\":\"https://docs.batchrelay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.batchrelay.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Batch Relay API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Batch Relay API","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Start","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Keyless Test Mode","href":"/keyless-test-mode"},{"title":"Authentication","href":"/authentication"}]},{"group":"Core Concepts","pages":[{"title":"Studio management","href":"/studio-management"},{"title":"Products","href":"/products"},{"title":"Catalog ownership and projection","href":"/catalog-projection"},{"title":"Shipping services","href":"/shipping-services"},{"title":"Managed assets","href":"/managed-assets"},{"title":"Asset sessions and event image imports","href":"/event-image-imports"},{"title":"Template renders","href":"/template-renders"},{"title":"Billing","href":"/billing"},{"title":"API-account activation and sandbox claims","href":"/activation"},{"title":"Idempotency","href":"/idempotency"},{"title":"Checkout Links","href":"/checkout-links"},{"title":"Studio discounts and offers","href":"/studio-offers"},{"title":"Promote sandbox studio setup","href":"/sandbox-promotions"},{"title":"Provider offers and quotes","href":"/provider-routing"},{"title":"Sandbox Testing","href":"/sandbox-testing"},{"title":"Errors","href":"/errors"}]},{"group":"Product reference","pages":[{"title":"Prints","href":"/products/prints"},{"title":"Wallets (set of 4)","href":"/products/wallet-set-4"},{"title":"4 × 5 Magnet","description":"Order one prepared 4 × 5 photo magnet per quantity.","href":"/products/magnet-4x5"},{"title":"3-inch Photo Button","href":"/products/photo-button-3"},{"title":"Acrylic keychains","description":"Choose a small or large two-sided acrylic keychain.","href":"/products/acrylic-keychains"},{"title":"Metal Keychain","href":"/products/metal-keychain"},{"title":"Bag tags","href":"/products/bag-tags"},{"title":"Trader Cards (set of 12)","href":"/products/trader-cards-12"},{"title":"Trader Card Magnets (set of 2)","href":"/products/trader-card-magnets-2"},{"title":"Contemporary plaques","href":"/products/contemporary-plaques"},{"title":"Memory Mates","href":"/products/memory-mates"},{"title":"Magazine Cover, 8 × 10","href":"/products/magazine-cover-8x10"},{"title":"Digital Download","href":"/products/digital-download"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/n8n"}]},{"tab":"Events","pages":[{"title":"Events","href":"/events/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/system/check-api-health"}]}]},"basePath":"","title":"3-inch Photo Button - Batch Relay API","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":[],"chunks":[]}