HomeDocumentationAPI Reference
Getting StartedAPI ReferenceBug ReportingCrash ReportingAPMHelp Center

SDK Locale for iOS

This section covers how to change the language of the SDK in your app as well as the content of all Instabug messages that your users see for iOS apps.

Setting the Locale

The SDK will automatically use the current locale of your user's device, however, you can override it with the following method.

Instabug.setLocale(.french)
[Instabug setLocale:IBGLocaleFrench];

Here are the possible locale values:

.arabic
.azerbaijani
.catalan
.catalanSpain
.chineseSimplified
.chineseTaiwan
.chineseTraditional
.czech
.danish
.dutch
.english
.french
.german
.italian
.japanese
.korean
.norwegian
.polish
.portuguese
.portugueseBrazil
.russian
.slovak
.spanish
.swedish
.turkish
.hungarian
.finnish
IBGLocaleArabic    
IBGLocaleChineseSimplified    
IBGLocaleChineseTaiwan
IBGLocaleChineseTraditional
IBGLocaleCzech
IBGLocaleDanish
IBGLocaleDutch
IBGLocaleEnglish
IBGLocaleFrench
IBGLocaleGerman
IBGLocaleItalian
IBGLocaleJapanese
IBGLocaleKorean
IBGLocaleNorwegian
IBGLocalePolish
IBGLocalePortugese
IBGLocalePortugueseBrazil
IBGLocaleRussian
IBGLocaleSlovak
IBGLocaleSpanish
IBGLocaleSwedish
IBGLocaleTurkish

📘

Dashboard Language

At the moment, the Instabug dashboard only supports English. Changing the SDK locale will not change the language of your dashboard.

Overriding String Values

You can also override each string shown to your users individually using the following method.

Instabug.setValue("Please enter a correct email address", forStringWithKey: kIBGInvalidEmailTitleStringName)
[Instabug setValue:@"Please enter a correct email address" forStringWithKey:kIBGInvalidEmailTitleStringName];

Here are the possible keys:

kIBGStartAlertTextStringName
kIBGShakeStartAlertTextStringName
kIBGTwoFingerSwipeStartAlertTextStringName
kIBGEdgeSwipeStartAlertTextStringName
kIBGScreenshotStartAlertTextStringName
kIBGInvalidEmailMessageStringName
kIBGInvalidEmailTitleStringName
kIBGInsufficientContentTitleStringName
kIBGInsufficientContentMessageStringName
kIBGInvocationTitleStringName
kIBGAskAQuestionStringName
kIBGReportBugStringName
kIBGReportFeedbackStringName
kIBGReportBugDescriptionStringName
kIBGReportFeedbackDescriptionStringName
kIBGReportQuestionDescriptionStringName
kIBGRequestFeatureDescriptionStringName
kIBGEmailFieldPlaceholderStringName
kIBGCommentFieldPlaceholderForBugReportStringName
kIBGCommentFieldPlaceholderForFeedbackStringName
kIBGCommentFieldPlaceholderForQuestionStringName
kIBGChatReplyFieldPlaceholderStringName
kIBGAddScreenRecordingMessageStringName
kIBGAddVoiceMessageStringName
kIBGAddImageFromGalleryStringName
kIBGAddExtraScreenshotStringName
kIBGAudioRecordingPermissionDeniedTitleStringName
kIBGAudioRecordingPermissionDeniedMessageStringName
kIBGScreenRecordingPermissionDeniedMessageStringName
kIBGMicrophonePermissionAlertSettingsButtonTitleStringName
kIBGMicrophonePermissionAlertLaterButtonTitleStringName
kIBGChatsTitleStringName
kIBGTeamStringName
kIBGRecordingMessageToHoldTextStringName
kIBGRecordingMessageToReleaseTextStringName
kIBGMessagesNotificationTitleSingleMessageStringName
kIBGMessagesNotificationTitleMultipleMessagesStringName
kIBGScreenshotTitleStringName
kIBGOkButtonTitleStringName
kIBGSendButtonTitleStringName
kIBGCancelButtonTitleStringName
kIBGThankYouAlertTitleStringName
kIBGThankYouAlertMessageStringName
kIBGAudioStringName
kIBGScreenRecordingStringName
kIBGImageStringName
kIBGReachedMaximimNumberOfAttachmentsTitleStringName
kIBGReachedMaximimNumberOfAttachmentsMessageStringName
kIBGVideoRecordingFailureMessageStringName
kIBGSurveyEnterYourAnswerTextPlaceholder
kIBGVideoPressRecordTitle
kIBGCollectingDataText
kIBGLowDiskStorageTitle
kIBGLowDiskStorageMessage
kIBGInboundByLineMessage
kIBGExtraFieldIsRequiredText
kIBGExtraFieldMissingDataText
kIBGSurveyIntroTitleText
kIBGSurveyIntroDescriptionText
kIBGSurveyIntroTakeSurveyButtonText
kIBGStoreRatingThankYouTitleText
kIBGStoreRatingThankYouDescriptionText
kIBGCustomSurveyThankYouTitleText
kIBGCustomSurveyThankYouDescriptionText
kIBGSurveysNPSLeastLikelyStringName
kIBGSurveysNPSMostLikelyStringName
kIBGSurveyNextButtonTitle
kIBGSurveySubmitButtonTitle
kIBGSurveyAppStoreThankYouTitle
kIBGSurveyAppStoreButtonTitle
kIBGExpectedResultsStringName
kIBGActualResultsStringName
kIBGStepsToReproduceStringName
kIBGReplyButtonTitleStringName
kIBGFeatureRequestsTitle 
kIBGFeatureDetailsTitle 
kIBGStringFeatureRequestsRefreshText 
kIBGFeatureRequestSortingByRecentlyUpdatedText 
kIBGFeatureRequestSortingByTopVotesText 
kIBGFeatureRequestErrorStateTitleLabel 
kIBGFeatureRequestErrorStateDescriptionLabel 
kIBGBetaWelcomeMessageWelcomeStepTitle;
kIBGBetaWelcomeMessageWelcomeStepContent;
kIBGBetaWelcomeMessageHowToReportStepTitle;
kIBGBetaWelcomeMessageHowToReportStepContent;
kIBGBetaWelcomeMessageFinishStepTitle;
kIBGBetaWelcomeMessageFinishStepContent;
kIBGBetaWelcomeDoneButtonTitle;
kIBGLiveWelcomeMessageTitle;
kIBGLiveWelcomeMessageContent;
kIBGReproStepsListHeader
kIBGReproStepsListEmptyStateLabel
kIBGReproStepsListTitle
kIBGReproStepsListItemName
kIBGReproStepsDisclaimerBody
kIBGReproStepsDisclaimerLink
kIBGDiscardAlertTitle
kIBGDiscardAlertMessage

What’s Next

The locale is reflected in all aspects of the Instabug SDK that your users see in your app, including the Welcome Message, bug reporting flow, and Prompt Options.