# Using fields with the Document Service API

> Source: https://docs.strapi.io/cms/api/document-service/fields

Use the `fields` parameter in Document Service API queries to select specific fields to return with your results, reducing data payload across `findOne()`, `findMany()`, `create()`, `update()`, `delete()`, `publish()`, and other document operations.

By default the [Document Service API](/cms/api/document-service) returns all the fields of a document but does not populate any fields. This page describes how to use the `fields` parameter to return only specific fields with the query results.

:::tip
You can also use the `populate` parameter to populate relations, media fields, components, or dynamic zones (see the [`populate` parameter](/cms/api/document-service/populate) documentation).
:::

:::note
Though it's recommended to target entries by their `documentId` in Strapi 5, entries might still have an `id` field, and you will see it in the returned response. This should ease your transition from Strapi 4. Please refer to the [breaking change entry](/cms/migration/v4-to-v5/breaking-changes/use-document-id) for more details.
:::

## Select fields with `findOne()` queries {#findone}

#### GET strapi.documents( — Select fields with findOne()

Select specific fields to return when finding a document by documentId.

**JavaScript:**
```
const document = await strapi.documents("api::restaurant.restaurant").findOne({
  documentId: 'a1b2c3d4e5f6g7h8i9j0klm',
  fields: ["name", "description"],
});
```

**Response 200 OK:**
```json
{
  documentId: "a1b2c3d4e5f6g7h8i9j0klm",
  name: "Biscotte Restaurant",
  description: "Welcome to Biscotte restaurant! …"
}
```

## Select fields with `findFirst()` queries {#findfirst}

#### GET strapi.documents( — Select fields with findFirst()

Select specific fields to return when finding the first matching document.

**JavaScript:**
```
const document = await strapi.documents("api::restaurant.restaurant").findFirst({
  fields: ["name", "description"],
});
```

**Response 200 OK:**
```json
{
  documentId: "a1b2c3d4e5f6g7h8i9j0klm",
  name: "Biscotte Restaurant",
  description: "Welcome to Biscotte restaurant! …"
}
```

## Select fields with `findMany()` queries {#findmany}

#### GET strapi.documents( — Select fields with findMany()

Select specific fields to return when finding multiple documents.

**JavaScript:**
```
const documents = await strapi.documents("api::restaurant.restaurant").findMany({
  fields: ["name", "description"],
});
```

**Response 200 OK:**
```json
[
  {
    documentId: "a1b2c3d4e5f6g7h8i9j0klm",
    name: "Biscotte Restaurant",
    description: "Welcome to Biscotte restaurant! …"
  }
  // ...
]
```

## Select fields with `create()` queries {#create}

#### GET strapi.documents( — Select fields with create()

Select specific fields to return when creating a new document.

**JavaScript:**
```
const document = await strapi.documents("api::restaurant.restaurant").create({
  data: {
    name: "Restaurant B",
    description: "Description for the restaurant",
  },
  fields: ["name", "description"],
});
```

**Response 200 OK:**
```json
{
  id: 4,
  documentId: 'fmtr6d7ktzpgrijqaqgr6vxs',
  name: 'Restaurant B',
  description: 'Description for the restaurant'
}
```

## Select fields with `update()` queries {#update}

#### GET strapi.documents( — Select fields with update()

Select specific fields to return when updating a document.

**JavaScript:**
```
const document = await strapi.documents("api::restaurant.restaurant").update({
  documentId: "fmtr6d7ktzpgrijqaqgr6vxs",
  data: {
    name: "Restaurant C",
  },
  fields: ["name"],
});
```

**Response 200 OK:**
```json
{
  documentId: 'fmtr6d7ktzpgrijqaqgr6vxs',
  name: 'Restaurant C'
}
```

## Select fields with `delete()` queries {#delete}

#### GET strapi.documents( — Select fields with delete()

Select specific fields to return when deleting a document.

**JavaScript:**
```
const document = await strapi.documents("api::restaurant.restaurant").delete({
  documentId: "fmtr6d7ktzpgrijqaqgr6vxs",
  fields: ["name"],
});
```

**Response 200 OK:**
```json
documentId: 'fmtr6d7ktzpgrijqaqgr6vxs',
  // All of the deleted document's versions are returned
  entries: [
    {
      id: 4,
      documentId: 'fmtr6d7ktzpgrijqaqgr6vxs',
      name: 'Restaurant C',
      // …
    }
  ]
}
```

## Select fields with `publish()` queries {#publish}

#### GET strapi.documents( — Select fields with publish()

Select specific fields to return when publishing a document.

**JavaScript:**
```
const document = await strapi.documents("api::restaurant.restaurant").publish({
  documentId: "fmtr6d7ktzpgrijqaqgr6vxs",
  fields: ["name"],
});
```

**Response 200 OK:**
```json
{
  documentId: 'fmtr6d7ktzpgrijqaqgr6vxs',
  // All of the published locale entries are returned
  entries: [
    {
      documentId: 'fmtr6d7ktzpgrijqaqgr6vxs',
      name: 'Restaurant B'
    }
  ]
}
```

## Select fields with `unpublish()` queries {#unpublish}

#### GET strapi.documents( — Select fields with unpublish()

Select specific fields to return when unpublishing a document.

**JavaScript:**
```
const document = await strapi.documents("api::restaurant.restaurant").unpublish({
  documentId: "cjld2cjxh0000qzrmn831i7rn",
  fields: ["name"],
});
```

**Response 200 OK:**
```json
{
  documentId: 'fmtr6d7ktzpgrijqaqgr6vxs',
  // All of the published locale entries are returned
  entries: [
    {
      documentId: 'fmtr6d7ktzpgrijqaqgr6vxs',
      name: 'Restaurant B'
    }
  ]
}
```

## Select fields with `discardDraft()` queries {#discarddraft}

#### GET strapi.documents( — Select fields with discardDraft()

Select specific fields to return when discarding a draft document.

**JavaScript:**
```
const document = await strapi.documents("api::restaurant.restaurant").discardDraft({
  documentId: "fmtr6d7ktzpgrijqaqgr6vxs",
  fields: ["name"],
});
```

**Response 200 OK:**
```json
{
  documentId: "fmtr6d7ktzpgrijqaqgr6vxs",
  // All of the discarded draft entries are returned
  entries: [
    {
      "name": "Restaurant B"
    }
  ]
}
```