---
title: "Templates"
description: "Templates: List templates, Create template, Retrieve template, Update template, Delete template, Duplicate template, Set the default template, List versions, Retrieve version, Restore version, List designs."
url: https://docs.invoicefalcon.com/v3-reference/templates/
api: "API v3 reference"
---

# Templates

## The template object

- `id` (integer): e.g. `125`
- `name` (string): e.g. `Main invoice`
- `document_type` (string): e.g. `invoice`
- `design` (object, nullable)
  - `key` (string): e.g. `modern`
  - `name` (string): e.g. `Modern`
- `default_for` (object)
  - `orders` (boolean): e.g. `true`
  - `draft_orders` (boolean): e.g. `false`
  - `pos_orders` (boolean): e.g. `false`
  - `credit_notes` (boolean): e.g. `false`
- `logo` (object)
  - `enabled` (boolean): e.g. `true`
  - `url` (string, nullable): e.g. `https://cdn.example.com/logo.png`
  - `width` (integer): e.g. `150`
  - `lock_aspect_ratio` (boolean): e.g. `true`
- `created_at` (string): e.g. `2026-11-10T09:07:41Z`
- `updated_at` (string): e.g. `2026-11-10T09:07:41Z`
- `style` (object)
  - `accent_color` (string): e.g. `#000000`
  - `font_family` (string): e.g. `Arial`
  - `font_size` (integer): e.g. `12`
  - `date_format` (string): e.g. `MMM DD, YYYY`
- `numbering` (object)
  - `prefix` (string): e.g. `INV`
  - `next_number` (string, nullable)
  - `use_order_number` (boolean): e.g. `true`
  - `credit_notes_use_order_number` (boolean): e.g. `false`
  - `sequential_numbering_available` (boolean): e.g. `true`
- `sections` (object)
  - `order_information` (object)
    - `show_invoice_number` (boolean): e.g. `true`
    - `show_custom_invoice_number` (boolean): e.g. `false`
    - `show_order_number` (boolean): e.g. `true`
    - `show_po_number` (boolean): e.g. `false`
    - `show_delivery_note_number` (boolean): e.g. `false`
    - `show_order_date` (boolean): e.g. `true`
    - `show_issue_date` (boolean): e.g. `false`
    - `show_due_date` (boolean): e.g. `false`
    - `show_fulfillment_date` (boolean): e.g. `false`
    - `show_payment_terms` (boolean): e.g. `false`
    - `show_order_amount` (boolean): e.g. `true`
    - `show_order_tags` (boolean): e.g. `false`
    - `show_barcode` (boolean): e.g. `false`
    - `show_order_barcode` (boolean): e.g. `false`
  - `payment_information` (object)
    - `show_payment_address` (boolean): e.g. `true`
    - `show_payment_method` (boolean): e.g. `true`
    - `show_payment_breakdown` (boolean): e.g. `false`
    - `show_credit_card` (boolean): e.g. `true`
    - `show_financial_status` (boolean): e.g. `false`
    - `show_discount_code` (boolean): e.g. `false`
    - `show_tax_date` (boolean): e.g. `false`
    - `show_tracking_company` (boolean): e.g. `false`
    - `show_tracking_numbers` (boolean): e.g. `false`
    - `show_paid_by_customer` (boolean): e.g. `true`
  - `shipping_information` (object)
    - `show_shipping_address` (boolean): e.g. `true`
  - `customer_information` (object)
    - `show_customer_email` (boolean): e.g. `true`
    - `show_customer_phone` (boolean): e.g. `true`
    - `show_customer_note` (boolean): e.g. `true`
    - `show_localized_tax_id` (boolean): e.g. `false`
    - `localized_tax_id_string` (string): e.g. `Tax ID`
  - `items` (object)
    - `show_product_images` (boolean): e.g. `true`
    - `show_sku` (boolean): e.g. `true`
    - `show_hs_code` (boolean): e.g. `false`
    - `show_product_weight` (boolean): e.g. `false`
    - `show_total_product_weight` (boolean): e.g. `false`
    - `show_country_of_origin` (boolean): e.g. `false`
    - `show_product_type` (boolean): e.g. `false`
    - `show_product_description` (boolean): e.g. `false`
    - `show_note_attributes` (boolean): e.g. `false`
    - `show_variants` (boolean): e.g. `true`
    - `show_selling_plan` (boolean): e.g. `false`
    - `show_item_discount` (boolean): e.g. `false`
    - `show_discount_reason` (boolean): e.g. `false`
    - `show_compare_at_price` (boolean): e.g. `false`
    - `show_original_price` (boolean): e.g. `false`
    - `show_properties` (boolean): e.g. `true`
    - `show_item_barcode` (boolean): e.g. `false`
    - `show_total_qty` (boolean): e.g. `false`
    - `show_item_tax` (boolean): e.g. `true`
    - `show_item_tax_amount` (boolean): e.g. `true`
    - `group_amount_digits` (boolean): e.g. `false`
  - `order_total` (object)
    - `show_subtotal` (boolean): e.g. `true`
    - `show_order_discount` (boolean): e.g. `true`
    - `show_order_discount_reason` (boolean): e.g. `false`
    - `show_discount_breakdown` (boolean): e.g. `false`
    - `show_tax` (boolean): e.g. `true`
    - `show_tax_inclusion_label` (boolean): e.g. `false`
    - `show_tax_breakdown` (boolean): e.g. `true`
    - `show_shipping` (boolean): e.g. `true`
    - `show_discounts` (boolean): e.g. `true`
    - `show_shipping_rate_name` (boolean): e.g. `true`
    - `show_amount_in_words` (boolean): e.g. `false`
    - `show_total_weight` (boolean): e.g. `false`
    - `show_refund_amount` (boolean): e.g. `true`
    - `show_refund_reason` (boolean): e.g. `false`
    - `show_payment_link` (boolean): e.g. `false`
    - `show_balance` (boolean): e.g. `true`
  - `extra` (object)
    - `show_order_notes` (boolean): e.g. `true`
    - `show_footer_notes` (boolean): e.g. `false`
    - `footer_message` (string, nullable)
    - `show_store_domain` (boolean): e.g. `false`
    - `store_domain_text` (string, nullable)
    - `show_paid_unpaid_watermark` (boolean): e.g. `false`
  - `social` (object)
    - `show_social_page` (boolean): e.g. `false`
    - `facebook_url` (string, nullable)
    - `instagram_url` (string, nullable)
    - `twitter_url` (string, nullable)
- `label_overrides` (object)
- `content_translations` (object)
- `liquid_code` (string): e.g. `    <!DOCTYPE html>
    <html>
    <head>
      <meta cha…`

```json
{
  "id": 125,
  "name": "Main invoice",
  "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": "https://cdn.example.com/logo.png",
    "width": 150,
    "lock_aspect_ratio": true
  },
  "created_at": "2026-11-10T09:07:41Z",
  "updated_at": "2026-11-10T09:07:41Z",
  "style": {
    "accent_color": "#000000",
    "font_family": "Arial",
    "font_size": 12,
    "date_format": "MMM DD, YYYY"
  },
  "numbering": {
    "prefix": "INV",
    "next_number": null,
    "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": true,
      "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…"
}
```

## Endpoints

- `GET /templates`: [List templates](https://docs.invoicefalcon.com/v3-reference/templates/list-templates.md)
- `POST /templates`: [Create template](https://docs.invoicefalcon.com/v3-reference/templates/create-template.md)
- `GET /templates/{id}`: [Retrieve template](https://docs.invoicefalcon.com/v3-reference/templates/retrieve-template.md)
- `PATCH /templates/{id}`: [Update template](https://docs.invoicefalcon.com/v3-reference/templates/update-template.md)
- `DELETE /templates/{id}`: [Delete template](https://docs.invoicefalcon.com/v3-reference/templates/delete-template.md)
- `POST /templates/{id}/duplicate`: [Duplicate template](https://docs.invoicefalcon.com/v3-reference/templates/duplicate-template.md)
- `POST /templates/{id}/set_default`: [Set the default template](https://docs.invoicefalcon.com/v3-reference/templates/set-the-default-template.md)
- `GET /templates/{id}/versions`: [List versions](https://docs.invoicefalcon.com/v3-reference/templates/list-versions.md)
- `GET /templates/{id}/versions/{version_id}`: [Retrieve version](https://docs.invoicefalcon.com/v3-reference/templates/retrieve-version.md)
- `POST /templates/{id}/versions/{version_id}/restore`: [Restore version](https://docs.invoicefalcon.com/v3-reference/templates/restore-version.md)
- `GET /templates/designs`: [List designs](https://docs.invoicefalcon.com/v3-reference/templates/list-designs.md)
