2019-12-02 07:06:45 -05:00
---
type: reference, howto
2020-07-17 11:09:13 -04:00
stage: Create
group: Editor
2020-11-26 01:09:20 -05:00
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"
2019-12-02 07:06:45 -05:00
---
2021-01-28 01:08:59 -05:00
# Snippets settings **(FREE SELF)**
2019-12-02 07:06:45 -05:00
Adjust the snippets' settings of your GitLab instance.
## Snippets content size limit
2020-05-21 02:08:25 -04:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/31133) in GitLab 12.6.
2019-12-02 07:06:45 -05:00
2020-07-17 11:09:13 -04:00
You can set a maximum content size limit for snippets. This limit can prevent
abuse of the feature. The default value is **52428800 Bytes** (50 MB).
2019-12-02 07:06:45 -05:00
### How does it work?
2021-01-27 19:09:33 -05:00
The content size limit is applied when a snippet is created or updated.
2020-07-17 11:09:13 -04:00
2020-10-02 17:08:18 -04:00
This limit doesn't affect existing snippets until they're updated and their
content changes.
2019-12-02 07:06:45 -05:00
### Snippets size limit configuration
This setting is not available through the [Admin Area settings ](../../user/admin_area/settings/index.md ).
In order to configure this setting, use either the Rails console
or the [Application settings API ](../../api/settings.md ).
2020-12-07 19:09:45 -05:00
NOTE:
2020-07-17 11:09:13 -04:00
The value of the limit **must** be in bytes.
2019-12-02 07:06:45 -05:00
#### Through the Rails console
The steps to configure this setting through the Rails console are:
1. Start the Rails console:
2020-01-30 10:09:15 -05:00
```shell
2019-12-02 07:06:45 -05:00
# For Omnibus installations
sudo gitlab-rails console
# For installations from source
2020-02-28 01:09:19 -05:00
sudo -u git -H bundle exec rails console -e production
2019-12-02 07:06:45 -05:00
```
1. Update the snippets maximum file size:
```ruby
ApplicationSetting.first.update!(snippet_size_limit: 50.megabytes)
```
To retrieve the current value, start the Rails console and run:
```ruby
Gitlab::CurrentSettings.snippet_size_limit
```
#### Through the API
2021-01-27 19:09:33 -05:00
To set the snippets size limit through the Application Settings API (similar to
[updating any other setting ](../../api/settings.md#change-application-settings )), use this command:
2019-12-02 07:06:45 -05:00
2020-01-30 10:09:15 -05:00
```shell
2020-12-09 01:09:41 -05:00
curl --request PUT --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/application/settings?snippet_size_limit=52428800"
2019-12-02 07:06:45 -05:00
```
You can also use the API to [retrieve the current value ](../../api/settings.md#get-current-application-settings ).
2020-01-30 10:09:15 -05:00
```shell
2020-12-09 01:09:41 -05:00
curl --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/application/settings"
2019-12-02 07:06:45 -05:00
```