---
title: "Update template"
description: "Change a template: its name, which order kinds it is the default for, logo, style, numbering, any editor section switch or text (sections.<group>.<field>, exactly as the read lists them), label overrides, content transla"
url: https://docs.invoicefalcon.com/v3-reference/templates/update-template/
api: "API v3 reference"
method: PATCH
path: "/templates/{id}"
---

# Update template

`PATCH https://app.invoicefalcon.com/api/v3/external/templates/{id}`

Change a template: its name, which order kinds it is the default for, logo, style, numbering, any editor section switch or text (`sections.&lt;group&gt;.&lt;field&gt;`, exactly as the read lists them), label overrides, content translations or the Liquid source. Deep partial. Returns the template in full.

**Note:** Applies to every document generated from this template from now on; existing PDFs are unchanged. Setting a `default_for` kind clears it on the other templates. The Pay now link needs a paid plan.

## Path parameters

- `id` (string, required): Template id.

## Request body

- `name` (string): Template name, unique in the store.
- `default_for` (object)
  - `orders` (boolean): Use this template for regular orders by default (clears it on the other templates).
  - `draft_orders` (boolean): Default for draft orders / quotes.
  - `pos_orders` (boolean): Default for POS orders.
  - `credit_notes` (boolean): Default for credit notes.
- `logo` (object)
  - `enabled` (boolean)
  - `url` (string, nullable): Logo image URL; replaces an uploaded logo.
  - `width` (integer, nullable): Logo width in pixels.
  - `lock_aspect_ratio` (boolean)
- `style` (object)
  - `accent_color` (string, nullable): Hex colour, e.g. #1a1a1a.
  - `font_family` (string, nullable)
  - `font_size` (integer, nullable)
  - `date_format` (string, nullable): e.g. MMM DD, YYYY or DD/MM/YYYY.
- `numbering` (object)
  - `prefix` (string, nullable): Invoice number prefix for this template.
  - `next_number` (string, nullable): Next sequential number (digits). Applied as sent; read the template first.
  - `use_order_number` (boolean): Number invoices after the Shopify order number.
  - `credit_notes_use_order_number` (boolean)
- `sections` (object)
  - `order_information` (object)
    - `show_invoice_number` (boolean)
    - `show_custom_invoice_number` (boolean)
    - `show_order_number` (boolean)
    - `show_po_number` (boolean)
    - `show_delivery_note_number` (boolean)
    - `show_order_date` (boolean)
    - `show_issue_date` (boolean)
    - `show_due_date` (boolean)
    - `show_fulfillment_date` (boolean)
    - `show_payment_terms` (boolean)
    - `show_order_amount` (boolean)
    - `show_order_tags` (boolean)
    - `show_barcode` (boolean)
    - `show_order_barcode` (boolean)
  - `payment_information` (object)
    - `show_payment_address` (boolean)
    - `show_payment_method` (boolean)
    - `show_payment_breakdown` (boolean)
    - `show_credit_card` (boolean)
    - `show_financial_status` (boolean)
    - `show_discount_code` (boolean)
    - `show_tax_date` (boolean)
    - `show_tracking_company` (boolean)
    - `show_tracking_numbers` (boolean)
    - `show_paid_by_customer` (boolean)
  - `shipping_information` (object)
    - `show_shipping_address` (boolean)
  - `customer_information` (object)
    - `show_customer_email` (boolean)
    - `show_customer_phone` (boolean)
    - `show_customer_note` (boolean)
    - `show_localized_tax_id` (boolean)
    - `localized_tax_id_string` (string, nullable)
  - `items` (object)
    - `show_product_images` (boolean)
    - `show_sku` (boolean): e.g. `false`
    - `show_hs_code` (boolean)
    - `show_product_weight` (boolean)
    - `show_total_product_weight` (boolean)
    - `show_country_of_origin` (boolean)
    - `show_product_type` (boolean)
    - `show_product_description` (boolean)
    - `show_note_attributes` (boolean)
    - `show_variants` (boolean)
    - `show_selling_plan` (boolean)
    - `show_item_discount` (boolean)
    - `show_discount_reason` (boolean)
    - `show_compare_at_price` (boolean)
    - `show_original_price` (boolean)
    - `show_properties` (boolean)
    - `show_item_barcode` (boolean)
    - `show_total_qty` (boolean)
    - `show_item_tax` (boolean)
    - `show_item_tax_amount` (boolean)
    - `group_amount_digits` (boolean)
  - `order_total` (object)
    - `show_subtotal` (boolean)
    - `show_order_discount` (boolean)
    - `show_order_discount_reason` (boolean)
    - `show_discount_breakdown` (boolean)
    - `show_tax` (boolean)
    - `show_tax_inclusion_label` (boolean)
    - `show_tax_breakdown` (boolean)
    - `show_shipping` (boolean)
    - `show_discounts` (boolean)
    - `show_shipping_rate_name` (boolean)
    - `show_amount_in_words` (boolean)
    - `show_total_weight` (boolean)
    - `show_refund_amount` (boolean)
    - `show_refund_reason` (boolean)
    - `show_payment_link` (boolean)
    - `show_balance` (boolean)
  - `extra` (object)
    - `show_order_notes` (boolean)
    - `show_footer_notes` (boolean)
    - `footer_message` (string, nullable)
    - `show_store_domain` (boolean)
    - `store_domain_text` (string, nullable)
    - `show_paid_unpaid_watermark` (boolean)
  - `social` (object)
    - `show_social_page` (boolean)
    - `facebook_url` (string, nullable)
    - `instagram_url` (string, nullable)
    - `twitter_url` (string, nullable)
- `label_overrides` (object): Label text per field, e.g. { &quot;invoice_number&quot;: &quot;Rechnungsnummer&quot; }.
- `content_translations` (object): Text per field per language, e.g. { &quot;footer_message&quot;: { &quot;de&quot;: &quot;Danke&quot; } }. The only field is footer_message; languages are the store locale codes (de, fr, es...). Sent whole: it replaces the stored value, and blank entries are dropped, so {} clears every translation.
- `liquid_code` (string): The Liquid source of the template body.

## Returns

The [template object](https://docs.invoicefalcon.com/v3-reference/templates/).

Rate limit: this call costs 2 points ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Example request

```sh
curl -X PATCH "https://app.invoicefalcon.com/api/v3/external/templates/125" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Renamed",
    "sections": {
      "items": {
        "show_sku": false
      }
    },
    "numbering": {
      "prefix": "R-",
      "next_number": "501"
    },
    "style": {
      "accent_color": "#ff0000"
    }
  }'
```

## 200

The updated resource.

```json
{
  "id": 175,
  "name": "Renamed",
  "document_type": "invoice",
  "design": {
    "key": "modern",
    "name": "Modern"
  },
  "default_for": {
    "orders": true,
    "draft_orders": false,
    "pos_orders": false,
    "credit_notes": false
  },
  "logo": {
    "enabled": true,
    "url": null,
    "width": 150,
    "lock_aspect_ratio": true
  },
  "created_at": "2026-11-10T09:07:44Z",
  "updated_at": "2026-11-10T09:07:44Z",
  "style": {
    "accent_color": "#ff0000",
    "font_family": "Arial",
    "font_size": 12,
    "date_format": "MMM DD, YYYY"
  },
  "numbering": {
    "prefix": "R-",
    "next_number": "501",
    "use_order_number": true,
    "credit_notes_use_order_number": false,
    "sequential_numbering_available": true
  },
  "sections": {
    "order_information": {
      "show_invoice_number": true,
      "show_custom_invoice_number": false,
      "show_order_number": true,
      "show_po_number": false,
      "show_delivery_note_number": false,
      "show_order_date": true,
      "show_issue_date": false,
      "show_due_date": false,
      "show_fulfillment_date": false,
      "show_payment_terms": false,
      "show_order_amount": true,
      "show_order_tags": false,
      "show_barcode": false,
      "show_order_barcode": false
    },
    "payment_information": {
      "show_payment_address": true,
      "show_payment_method": true,
      "show_payment_breakdown": false,
      "show_credit_card": true,
      "show_financial_status": false,
      "show_discount_code": false,
      "show_tax_date": false,
      "show_tracking_company": false,
      "show_tracking_numbers": false,
      "show_paid_by_customer": true
    },
    "shipping_information": {
      "show_shipping_address": true
    },
    "customer_information": {
      "show_customer_email": true,
      "show_customer_phone": true,
      "show_customer_note": true,
      "show_localized_tax_id": false,
      "localized_tax_id_string": "Tax ID"
    },
    "items": {
      "show_product_images": true,
      "show_sku": false,
      "show_hs_code": false,
      "show_product_weight": false,
      "show_total_product_weight": false,
      "show_country_of_origin": false,
      "show_product_type": false,
      "show_product_description": false,
      "show_note_attributes": false,
      "show_variants": true,
      "show_selling_plan": false,
      "show_item_discount": false,
      "show_discount_reason": false,
      "show_compare_at_price": false,
      "show_original_price": false,
      "show_properties": true,
      "show_item_barcode": false,
      "show_total_qty": false,
      "show_item_tax": true,
      "show_item_tax_amount": true,
      "group_amount_digits": false
    },
    "order_total": {
      "show_subtotal": true,
      "show_order_discount": true,
      "show_order_discount_reason": false,
      "show_discount_breakdown": false,
      "show_tax": true,
      "show_tax_inclusion_label": false,
      "show_tax_breakdown": true,
      "show_shipping": true,
      "show_discounts": true,
      "show_shipping_rate_name": true,
      "show_amount_in_words": false,
      "show_total_weight": false,
      "show_refund_amount": true,
      "show_refund_reason": false,
      "show_payment_link": false,
      "show_balance": true
    },
    "extra": {
      "show_order_notes": true,
      "show_footer_notes": false,
      "footer_message": null,
      "show_store_domain": false,
      "store_domain_text": null,
      "show_paid_unpaid_watermark": false
    },
    "social": {
      "show_social_page": false,
      "facebook_url": null,
      "instagram_url": null,
      "twitter_url": null
    }
  },
  "label_overrides": {},
  "content_translations": {},
  "liquid_code": "    <!DOCTYPE html>\n    <html>\n    <head>\n      <meta charset=\"utf-8\">\n      <link href=\"https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Open+Sans:wght@400;600;700&family=No…"
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 404

The resource does not exist for this shop, or no action is registered at this path.

```json
{
  "errors": [
    "Resource not found"
  ],
  "code": "not_found"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

